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Java 


w pigułce 


„Napisz raz, uruchom wszędzie” - nie sposób innymi słowami 
rozpocząć książki o języku programowania Java. Angielskie 
„Write once, run anywhere” (w skrócie WORA) to hasło 
podkreślające główną zaletę Javy — jej wieloplatformowość 


H asło „Napisz raz, uruchom wszędzie” zo- 
stało wymyślone w firmie Sun Microsys- 
tems, która stworzyła język programowania 
Java. I choć Sun Microsystems już nie istnieje 
- zostało przejęte przez innego giganta IT, 
firmę Oracle - hasło nadal jest aktualne i na 
stałe wpisało się w historię informatyki. 
Pierwsza wersja Javy, stworzona przez grupę 
roboczą pod kierunkiem Kanadyjczyka Ja- 
mesa Goslinga, została wydana w 1995 roku. 
Przez lata Java zdobyła pozycję jednego z naj- 
popularniejszych języków, a programiści 
w niej pracujący nie mogą narzekać ani na 
brak pracy, ani na niskie zarobki. 
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Maszyna wirtualna 


kąd właściwie bierze się wspomniana 

wieloplatformowość? Zawdzięczamy ją 

temu, że Java jest językiem tworzenia progra- 
mów źródłowych kompilowanych do kodu 
bajtowego - postaci wykonywanej przez ma- 
szynę wirtualną. To właśnie wykorzystanie 
maszyny wirtualnej sprawia - że kod raz na- 
pisany będzie skutecznie działał na sprzęcie 
o różnej architekturze i z różnymi systemami 
operacyjnymi (choćby Windows czy Linux). 
Wymagane jest jednak, by na sprzęcie tym 
była zainstalowana ta wirtualna maszyna. 
Maszyna wirtualna Javy (Java Virtual Ma- 
chine, w skrócie nazywana jest JVM) to 
zestaw aplikacji napisanych na tradycyjne 
urządzenia i systemy operacyjne. W zależno- 
ści od potrzeb i liczby dostępnych narzędzi 
wyróżniane są dwa główne zestawy: 

m JRE - Java Runtime Environment - za- 
wiera wyłącznie narzędzia niezbędne do 
uruchomienia aplikacji, czyli środowisko 
uruchomieniowe; 

m JDK - Java Development Kit - zawiera 
również narzędzia dla programistów po- 
zwalające na tworzenie aplikacji na plat- 
formę JVM. 

Co ważne - określenie wirtualna maszyna 

Javy nie jest nazwą konkretnego produk- 


E; What is this? Tre pisc 
k source implęcn 
ana ref 


Strona internetowa OpenJDK - openjdk.java.net 


tu. Dostępna jest specyfikacja pozwalająca 
różnym producentom oprogramowania na 
tworzenie własnych maszyn wirtualnych 
pracujących pod kontrolą różnych środowisk 
i urządzeń. Firma Oracle Corporation, wła- 
Ściciel znaku towarowego Java, udostępnia 
swoją maszynę wirtualną. Inne firmy także 
mogą tworzyć JRE i JDK i używać w swoich 
produktach znaku Java pod warunkiem, że 
ściśle przestrzegają oficjalnej specyfikacji 
i dodatkowych regulacji. 

W tej książce są przedstawione projekty pro- 
gramistyczne do zrealizowania. Aby je wyko- 
nać, nie wystarczy mieć JRE. Niezbędne jest 
także JDK z narzędziami programistycznymi. 
Począwszy od Javy 7, wzorcową implementa- 
cją JVM jest OpenJDK (IAMATE). Jest to 
otwarte oprogramowanie i to właśnie jego 
wykorzystanie opisano w tej książce. 


Czy warto uczyć się Javy? 


o pytanie można uznać za retoryczne. 

Java może być dobrym sposobem na po- 
czątek przygody z programowaniem. 
Język ten jest stosunkowo prosty - zawiera 
jedynie 50 słów kluczowych, a jednocześ- 
nie oferuje bogate możliwości dzięki roz- 
budowanemu zestawowi bibliotek (APN), 
które można wykorzystywać w projektach. 
Wspomniana wieloplatformowość Javy 
przejawia się także tym, że daje nam moż- 
liwość pisania aplikacji także na urządzenia 


mobilne. Znając język Java, można zacząć 
tworzenie aplikacji na platformę Android. 
Firma Google udostępnia zestaw SDK 
(ang. Software Developer Kit) do tworze- 
nia oprogramowania właśnie przy użyciu 
języka Java. 

Ważnym argumentem jest to, że Java to na- 
rzędzie potężne - wszechobecne, a co za tym 
idzie, daje programistom wiele udogodnień, 
których często brakuje osobom piszącym 
skrypty w innych językach. 
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Java w pigułce 


Jak zacząć pracę w Javie 


D:. rozpoczęcia pra- 
cy nad projektami 
w języku Java może wy- 


Apache NetBeans 


starczyc sam pakiet Java Fits the Pieces Together 

Development Kit. Quickiy and easily develop desktop. mobile, and web applicafions 
OpenJDK nie trzeba th Ja aScnpt, HIML5, PHP, C/C++ and more. 

. 2 > No s 6 froo and opon source and s qovomed by the 
instalować, wystarczy Apache Software Foundafon 


wypakować do wybra- 
nej lokalizacji archiwum 


zamieszczone na płycie 
ź $ó_5 Easy 8 Efficient Rapid User Interface write Bug Free 
dołączonej do książki. Project Management Code 


Development 
Warto też wiedzieć, że na Prgiect 
z Faworkes = 


stronie jdk.java.net ©, 


zawsze znajdziemy naj- 
Strona internetowa oprogramowania NetBeans IDE - netbeans.org 


nowsze wersje pakietu 
do pobrania. 
Teoretycznie, mając JDK, 
możemy już programo- 
Ustawienie zmiennych 
środowiskowych 
. h Kopiujemy lokalizację € folderu, w któ- 
|| d k J a Va . n et rym znajduje się rozpakowane OpenjDK. 


Feotured News: ars | appeveć to My [ srocte NetOeans "uc © ee All News 


wać w Javie, wykorzy- 
stując do pisania choćby 


€3C0 śkkaam 


Java Development Kit builds, from Oracle 322 = |jdk-1302 
| | Narzędzia główne udostępnianie widok 
+ « 1|2 EMMMSME | 
Ready for use: JDK 13, JMC 
J Muzyka A Nazw 
Early access: JDK 15, JDK 14, jpackage, Loom, OpenjFX, 
Panama, 6 Valnalla 8 Obiekty 3D B bin 
Reference implementatlons: Java SE 13, 12, 11, 10, 9, R Obrazy 1 cont 
8,6 7 + Pobrane 2 include 
IB Pulpit 2. jmods 
EH wideo 2. legal 
0510) R w 
. , ; DATA (D; ] release 
zwykły Notatnik. W praktyce może być to 
zadanie trudne i niewygodne. Dlatego oprócz Korzystając z wyszukiwarki systemo- 
JDK dobrze jest wyposażyć się w IDE. W tym wej Windows, znajdujemy opcję Edytuj 
wypadku może to być NetBeans IDE (I[X zmienne środowiskowe systemu ©. 
KOD: 003) wszystko  Aglkacje | Dolume wie sok: WiGi= 


Aby móc w pełni korzystać 

z JDK, trzeba jeszcze wykonać anek 
kilka czynności. Jeśli tego nie Pam e a 
zrobimy, może to uniemożli- KADRZE | 
wić instalację NetBeans IDE. 


kaj w sieci Web Edytuj zmienne śrociowiskowe systemu 


A edytuj zmienne środowiskowe 
Systemu - Zobacz wynika 7 sec: Web 
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W otwartym w ten sposób oknie Właś- 
ciwości systemu klikamy na przycisk 
Zmienne środowiskowe 


4* sekcji Zmienne systemowe klikamy 
na przycisk Nowa ©. 


Zmienne systemowe 


Znserna Wartość c 
NUM8ER_OF_PROCESSORS 12 

05 Windows_Nt 

Path CAProgram Files (86)Ysten Intel(R) Managememt Engite Co. 
PATHEXT KOM .EXE-BAT.CND-V8S:VBE-JS-/SE- WSE. WSH: MSC 
PROCESSOR ARCHITECTU.. AMD64 


PROCESSOR JDENTIFIER 
PROCESSOR, 


Intetó4 Famsży 6 Model 158 Stegping 10, Genanetniel 
6 


Sdytu Usuń 


W pole Nazwa © wpisujemy JAVA_ 
HOME, a w pole Wartość wklejamy 
skopiowaną wcześniej lokalizację © rozpa- 
kowanego OpenJDK. Zatwierdzamy dodanie 
zmiennej przyciskiem OK. 


Nazwa JAVA _HOMF 


Wartość Cawajdk-13.0.2 


Przeglądaj katalog. Przeglądaj plik. OK Anżtaj 


Po dodaniu zmiennej należy jeszcze 
edytować zmienną Path. Zaznaczamy 
ją, a następnie klikamy na przycisk Edytuj 


Zmienne systemowe 


Zmienna Wartość A 
NUMBER_OF_PROCESSORS 12 

os Windówś_NT 

Path CAProgram Files (x86)Vmtefiintel(R) Management Engine Co_ 
PATHEXT COM; EXE; 8AT;CMD,VB$;VBE-JS;JSE; WSE, WSH; MSC 
PROCESSOR_ARCHITECTU_ AMD64 


PROCESSOR ZDENTIIER Inteló< Family 6 Model 158 Stepping 10, Genuinelntel 


Nowa. 


W oknie edycji zmiennej Path klikamy 
na przycisk Nowy. Do pustego paska 


4 0510 A Narwa 1a tw A 


2 nawOewe 


Nazwa kompulera Sprzęt Zaawansowane Ochrona systemu Zdalny 


Aby móc przeprowadzić większość tych zmian. musisz zalogować się jako 


Administrator 
Wydajność 
Efekty wizualne. planowanie użycia procesora. wykorzystanie pamięcii 
pamięć wirtualna 
Ustawionia 
Prośle użytkownika 
Ustawienia pulpau związane z logowaniem 
Ustawienia 


Uruchamianie i odzyskiwanie 


Informacje o uruchamianiu systemu, awarrach systemu i debugowaniu 


Ustawienia 
Zmienne środowiskowe. 
OK Anuluj Zastosuj 

CAProgram Files (x86)nteNntel(R) Management Engine Comp... Nowy 
CAProgram Filestintentel(R) Management Engine Components. 
CAWindowsisystem32 Edytuj 
CAWindows 
CAWindows|System321Wbem Przeglądaj... 
CAWindowsiSystem321WindowsfowerShelnv1.04 
CAWindowsiSystem321OpenSSH Usuń 
CAProgram Files ((86)ntehntel(R) Management Engine Comp. 
CAProgram fiiestintenintel(R) Management Engine Components_ 
CAProqram Files RMOPEŃ Manaqement Engine Comp. je w górd 
CAProgram Filesntenntel(R) Management Engine Components. 
CAProgram Files (x86)NNVIDIA Corporation Phys( (Common z 
CAProgram Fileś inten WiFI bin ZZ 
CAProgram filesiCommon filesiinten WirelesscCommom 
CAProqram Filesydotnet| 

Edytuj tekst... 


CAProgram FilesiMicrosoft SQL Server(130ToolsiBinni 
CAProgram FilesyMicrosoft SQL ServeriClient SDKLODBCJ1704To_ 
CAjavaydk-13.0.24bin 


wklejamy tę samą lokalizację co wcześniej 
jednak dopisując na końcu bin 
lokalizacja odnosiła się do folderu 
w rozpakowanym archiwum OpenJDK. Na 
koniec przyciskiem OK zatwierdzamy edycję 
zmiennej środowiskowej Path. 


Kolejno przyciskami OK zamykamy okna 
Zmienne środowiskowe i Właściwości 
systemu. 
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Pojęcia warte wyjaśnienia 


anim przejdziemy do realizacji projek- 

tów, warto poznać kilka istotnych po- 
jęć, które będą często pojawiały się w tej 
książce: 


m Apache Maven - narzędzie automatyzu- 
jące budowę oprogramowania na plat- 
formę Java. Podczas budowania potrafi 
zrobić wszystko z naszym projektem. 
Jedyne, o czym musimy pamiętać, to 
stosować odpowiednie nazewnictwo 
katalogów w projekcie (tak jak wymaga 
tego Maven). Dalej już sam Maven zatrosz- 
czy się o kompilowanie kodu, wykony- 
wanie testów, pilnowanie bibliotek oraz 
ich wersji, generowanie pliku .jar z naszą 
aplikacją czy dokumentacji. Zadba także 
o wiele innych czynności, które bez au- 
tomatyzacji mogą okazać się czasochłon- 
ne, a także powodować występowanie 
błędów. 


m Dokumentacja programu - to nazwa 
odnosząca się do całości dokumentacji, 
czyli dokumentacji użytkownika i doku- 
mentacji technicznej stworzonej przez 
twórców programu. 


m Dokumentacja techniczna - jest tworzo- 
na przez twórców na ich własne potrzeby, 
ale też na potrzeby innych osób chcących 
modyfikować kod programu. Powinna 
zawierać dokładny opis poszczególnych 
elementów kodu, wyjaśniać ich działanie 
i wykorzystanie. 


m Dokumentacja użytkownika - to opis 
programu przeznaczony dla jego użytkow- 
nika, w jej skład wchodzą najczęściej pliki 
pomocy i instrukcja obsługi. 


m Instrukcja warunkowa - element języ- 
ków programowania, który uzależnia wy- 
konywanie wybranych przez programistę 
instrukcji od tego, czy przedstawione 
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wyrażenie logiczne jest prawdą, czy też 
fałszem. 


m Klasa - termin odnoszący się do para- 
dygmatu programowania obiektowego. 
Jest to definicja (lub częściowa definicja) 
obiektów. Klas używa się bardzo często 
do odzwierciedlenia świata rzeczywistego 
w kodzie programu. 


m Metoda - podprogram składowy klasy. 
Odpowiada za działanie konkretnych 
elementów klasy. Na przykład dla klasy 
Piłkarz metodami mogą być wykonywane 
przez Piłkarza czynności, takie jak bieg, 
strzał, podanie czy wślizg. 


m Obiekt - instancja klasy. Na przykład, jeśli 
mamy klasę Piłkarz, obiektami będą po- 
szczególni piłkarze. 


m Pętla - jedna z podstawowych konstruk- 
cji programistycznych. Pętle umożliwiają 
cykliczne wykonywanie ciągu instrukcji. 
W zależności od rodzaju pętli cykl ten 
jest wykonywany określoną liczbę razy 
do momentu zajścia pewnych warun- 
ków dla każdego elementu kolekcji lub 
w nieskończoność. 


m Swing - biblioteka graficzna Javy. To 
dzięki niej możemy korzystać z takich 
elementów, jak przyciski, pola tekstowe 
czy panele, a także inne elementy wyglądu 
aplikacji. 


m Testy jednostkowe - metoda sprawdzania 
poprawności działania programu poprzez 
sprawdzanie jego poszczególnych elemen- 
tów (jednostek), na przykład metod, obiek- 
tów, procedur, zależnie od typu języka. 


m Zmienna - w uproszczeniu jest to kon- 
strukcja, która pod określoną nazwą po- 
zwala na przechowywanie wartości. 
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Java - podstawy składni 


ava jest językiem zorientowanym obiek- 

towo. To oznacza, że podczas pisania 
będziemy tworzyć tak zwane klasy. Są one 
definicjami dla obiektów, które w zasadzie 
powinny odzwierciedlać świat zewnętrzny. 
Również na poszczególne elementy progra- 
mu będziemy patrzeć przez pryzmat klas. 
I tak obiektem jest też na przykład okno 
programu. 


O tym, jak tworzyć klasy, dowiemy się w dal- 
szej części książki. Podczas tworzenia klas 
nie obejdzie się na przykład bez koniecz- 
ności deklaracji zmiennych. Te w skrócie 
możemy określić jako parę, w skład której 
wchodzi nazwa i wartość przechowywana 
pod konkretną nazwą. 

Java jest jednak językiem silnie typowanym 
- to oznacza, że każda zmienna czy pole 
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(polem nazywamy zmienną działającą w ob- 
szarze klasy) oprócz nazwy i wartości musi 
mieć jeszcze swój zadeklarowany typ. 

I tak, jeśli pod nazwą punkty chcemy prze- 
chowywać w grze liczbę zdobytych przez 
gracza punktów, to powinniśmy zastanowić 
się, jaka może to być liczba. 
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To dlatego, że typ zmiennych odpowiada 
za rodzaj i zakres wartości, jakie może ta 
zmienna przechowywać. Innych typów 
zmiennych używamy do przechowywania 
liczb całkowitych, a innych do przecho- 
wywania ułamków (te nazywamy liczbami 
zmiennoprzecinkowymi). 


[B) 


package com.mycompany.mavenexample ; |A| 
import java.awt.Graphics; 
import java.awt.event.ActionEvent; 
import java.awt.event.ActionListener; 
import javax.swing.Timer; 


public class jPanell extends javax.swing.JPanel implements ActionListener f 
|F int pal _h,pal w,pal_ x,pal_y; 
Timer timer; 


Graphics gr; 


[| public jPanel1() ( 
initComponents () ; 


pal_h = 10; 

pal w = 50; 

pal_x = NewJFrame.WIDTH/2 — pal_w/2; 
pal_y = NewJFrame.HEIGHT -— pal_h; 
timer = new Timer(150, this); 


timer.start (); 
) 
|H | GOverride 
public void actionPerformed(ActionEvent e) ( 
repaint () ; 
, 


private void initComponents() ( 


javax.swing.GroupLayout layout new javax.swing.GroupLayout (this) ; 
this.setLayout (layout) ; 
layout.setHorizontalGroup ( 
layout.createParallelGroup (javax.swing.GroupLayout.Alignment.LEADING) 
„addGap(0, 400, Short.MAX VALUE) 
); 
layout.setVerticalGroup ( 
layout.createParallelGroup (javax.swing.GroupLayout.Alignment .LEADING) 
.addGap(0, 300, Short.MAX VALUE) 
); 
ł 


GOverride 
public void paintComponents (Graphics g) 
t 
g.drawRect (pal_x, pal_y, pal w, pal_h); 
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Typy zmiennych różnią się między sobą także 
rozmiarem. To znaczy, że mogą przechowy- 
wać wartości na różnej liczbie bitów w pa- 
mięci. Nierozsądne deklarowanie zmiennych 
może prowadzić do dużego zapotrzebowa- 
nia programu na pamięć operacyjną. Dlate- 
go dobierając typ zmiennych, analizujemy 
najpierw, jakie wartości może ona przyjąć 
iw jakim zakresie się one mieszczą, aby sko- 
rzystać z najmniejszego możliwego typu, wy- 
starczającego do przechowania potrzebnej 
wartości. 


Podstawy składni 

języka Java 

Podstawy składni języka Java omówimy na 
przykładowym skrypcie (patrz ilustracja na 
stronie obok). 

Już na pierwszy rzut oka zwracają uwagę 
nawiasy klamrowe f). W Javie odpowiadają 
one za wydzielanie fragmentów kodu. 

To, co znajduje się wewnątrz nawiasu klam- 
rowego, może być treścią - klasy, metody 
czy pętli lub innej konstrukcji. 


GO TO JEST DZIEDZICZENIE 


Dziedziczenie jest jednym z funda- 
mentów programowania obiektowego. 
Jego ideę najlepiej wytłumaczyć na 
przykładzie. 

Załóżmy, że mamy klasę Siatkarz. Siat- 
karze grający na różnych pozycjach na 
boisku mają wiele wspólnych zachowań 
i właściwości. 

Są jednak także cechy, którymi się 
różnią, na przykład zawodnik libero nie 
atakuje. 

Wszystkie aspekty wspólne dla siatkar- 
skich pozycji możemy opisać w klasie 
Siatkarz. A tworząc w grze zawodników 
na różnych pozycjach, możemy tworzyć 
klasy dziedziczące po klasie Siatkarz. 
W ten sposób zaoszczędzimy sobie 
pracy — elementy wspólne klas trafiają 
do nich na zasadzie dziedziczenia, bez 
konieczności pisania ich w każdej z klas. 


Niektóre konstrukcje zawierają się wewnątrz 
innych, stąd często u dołu skryptów widzi- 
my wiele zamknięć nawiasów - każdy zamy- 
ka inną część skryptu. 

Przyjrzyjmy się kilku linijkom tego kodu, aby 
poznać ich działanie: 


[I package - pozwala określić przestrzeń 
nazw projektu. Mówiąc ogólnie - jest 
zbiorem między innymi klas i interfej- 
sów, z których jest zbudowany projekt. 


[HB import - pozwala dodać do projektu za- 
wartość innych przestrzeni nazw. 


[H słowo class pozwala zadeklarować 
klasę, w tym przypadku klasę o nazwie 
jPanel1. 


[I] słowo extends oznacza, że nasza klasa 
będzie dziedziczyć po innej klasie - ja- 
vax.swing.JPanel. 


I implements - pozwala na dodanie in- 
terfejsu o nazwie AetionListener, po 
którym klasa również może dziedziczyć. 
Interfejs nazywany jest często „spisem 
treści” dla klasy. Interfejs w kontekście 
programowania w języku Java to ze- 
staw metod bez ich implementacji (bez 
kodu definiującego zachowanie każdej 
metody). 


[i deklaracja pól klasy, czyli mówiąc 
w skrócie - zmiennych, które są dostęp- 
ne dla wszystkich metod tej klasy. 


[EJ] specjalna metoda klasy nazywana kon- 
struktorem. Dzięki niej możliwe jest 
tworzenie obiektów klasy. Najczęściej 
to w konstruktorze pola klasy dostają 
swoje wartości. 


[I ©Override oznacza, że kolejna opisana 
metoda zostaje nadpisana. To znaczy: 
treść metody odziedziczona po klasie, po 
której zrobiliśmy dziedziczenie, zostaje 
zastąpiona nową treścią. 
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Jak pracować 
w Javie 


Do tworzenia własnych programów w Javie wystarczy JDK 

i prosty edytor tekstu. Nie jest to jednak jedyna możliwość. 
W tym rozdziale zobaczymy też, że do pracy w Javie można 
wykorzystać także dodatkowe oprogramowanie 


— tak zwane IDE 


R ealizując wskazówki 
przedstawione w tym 
rozdziale, stworzymy swoje 
pierwsze skrypty w Javie. 
Kiedy zaopatrzymy swój 
komputer w JDK, wystarczy 
użycie najprostszego edytora 
tekstu, nawet Notatnika, by 
móc tworzyć swoje pierwsze 
programy w Javie. Pozwoli to 
także lepiej zrozumieć pod- 
stawy języka. A następnie za- 
poznamy się z działaniem IDE 
- zintegrowanego środowiska 
programistycznego. 


JAVA ZACZNIJ PROGRAMOWAĆ 


IDE 


IDE, czyli zintegrowane środowisko programistyczne, 
to program lub zespół programów służących do 
tworzenia, modyfikowania, testowania i konserwacji 
oprogramowania. IDE jest bardzo ważne - chociaż nie 
jest niezbędne, by rozpocząć pracę w Javie, to bardzo 


ją usprawnia. 

Dlatego w dalszej części tego rozdziału i w kolejnych 
opisano wykorzystanie Apache NetBeans IDE (DVD- 
KOD: 003 ). Warto wiedzieć, że podobną funkcjonalność 
oferują też na przykład Eclipse IDE ( DVD-KOD: 006 ) czy 
IntelliJ ( DVD-KOD: 013 ), które także znajdują się na płycie 
dołączonej do książki. 


adam1l3zajacigmail.com 


Hello World 


H ello World (Witaj, świecie) to klasyczny 
program, którego celem jest wypisanie 
na standardowym wyjściu napisu „Hello 
World!” (lub innego dowolnego, prostego 
komunikatu). Jego przeznaczeniem jest jedy- 
nie demonstracja języka czy też środowiska, 
w jakim został napisany. Nazwą tą określa się 
też różne inne proste programy, których je- 
dynym zadaniem jest pokazywanie działania 
języka programowania. Początkujący progra- 
miści, ucząc się nowego języka lub w ogóle 
zaczynając naukę programowania, często 
stawiają sobie jako pierwsze zadanie samo- 
dzielne napisanie programu Hello World. My 
również tak zrobimy: 


Otwieramy Notatnik © systemowy, aby 
rozpocząć pisanie skryptu. 


2 Pierwsza linijka - public class Hello- 
Worldf £] - zawiera deklarację publicz- 
nej klasy o nazwie HelloWorld. Kończy się 
otwarciem nawiasu klamrowego. Wszystko, 
co napiszemy przed jego zamknięciem, bę- 
dzie treścią naszej klasy. 


— Wszystko Aplikacje Dokument 


A Najlepszy wynik 


Notatnik 
Aplikacja 


Aplikacje 
[Z Sticky Notes > 
Wyszukaj w sieci Web 


£ nota acz wyniki z sieci Wet > 


Trzecia linia kodu - System.out.println 

("Hello World”); [3] - to właściwe ciało 
naszej aplikacji. Jest to wywołanie metody 
wyświetlającej tekst na konsoli. Tym razem 
nie otwieramy klamrowego nawiasu, ponie- 
waż nic tu nie definiujemy, tylko wywołuje- 
my konkretne polecenie. Wywołanie metody 
kończy się znakiem średnika, można go po- 


public. class Helloworldf LJ 


) 


public static void main(String[] args) [EH] 
System.out.println("Hello World") ;[Ą] 


równać do kropki kończącej 
zdanie. W kolejnych liniach 
moglibyśmy wypisywać kolej- 
ne polecenia - wykonywały- 
by się one w kolejności, w ja- 
kiej byśmy je ułożyli. Podany 


Linijka druga - public static void ma- 

in(Stringl] args)( £] - zawiera deklara- 
cję głównej metody aplikacji: main. 
Ta metoda jest uruchamiana jako pierwsza 
w aplikacji i dopiero w niej wywoływane 
Są inne metody. 
Po nazwie metody znajduje się deklaracja 
przyjmowanych argumentów, w tym wy- 
padku są to również argumenty wejściowe 
całej aplikacji. Linijka kończy się otwarciem 
nawiasu klamrowego - to oznacza, że dalsza 
część skryptu, aż do zamknięcia tego nawia- 
su, będzie treścią metody main. 


do wyświetlenia w konsoli 
tekst został wpisany w cudzysłowie, można 
w nim wpisać dowolną treść, jaką chcemy 
wyświetlić. 


Kolejna linijka kodu zawiera zamknię- 

cie nawiasu klamrowego. Zamyka ten 
nawias, który został ostatnio otwarty, czyli 
kończy treść metody main. 


Drugie zamknięcie, w kolejnej linii skryp- 

tu, odnosi się do najbliższego otwartego 
nawiasu klamrowego, który nie został jeszcze 
zamknięty. Zamyka zatem definicję klasy. 
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jak pracować w Javie 


Zagisywacie |a40 


Napisany w ten sposób skrypt 
powinniśmy zapisać do odpo- A=" 7% 


wiedniego pliku. Z menu Plik wy- | „„... * — — z 
bieramy opcję Zapisz ©. = m M i ma || 


J Muzya 
3 Obiekty 30 My Web Sites NetBeaniPiojeciś Oceniaczka wie PICoinoS 
Plik Edycja Format Widok Pomoc EE Oteazy 
No Cri+N 4 Foo ore U R" =| c 
żę | q M Popa ż 0 ry hę 
Otwórz. Cti+O B wa p u 
Zapisz Gm+S 4 05K Sareddames Scratch Spel 5nagpstct VideoCutost 
Zapisz jako. + DAJA (O y : 
Ustawienia strony... Nazwa pliku: | *łellowodjara 
Drukuj. Cili+P Zapisz jeke typ Wszystkie piki 
Zakończ 4 Usyj tolsery Kocowanie: ANSI [ _ Zapisz ] Arulej 
x 


W oknie dialogowym wybieramy lo- Wiersz polecenia 
kalizację, w której ZODGTUSPZYDCZYWY Ju; crosoft Windows [Version 10.6.17763.073] 
plik. Wpisujemy też jego nazwę - |LJEJJCC) 2018 Microsoft Corporation. Wszelkie prawa zastrzeżone. 
loWorld.java 6, a w polu Zapisz jako 
typ wybieramy opcję Wszystkie pliki. 


C : Users Vkonra>cd C: NUsersMkonraDocuments 


Gdy będziemy już w lokalizacji pliku, 
Kompilacja wpisujemy javac HelloWorld.java 
Tak napisany skrypt sam się jeszcze nie wy- 
kona. Trzeba dokonać jego kompilacji, by 
wytworzyć kolejny plik, i dopiero jego uru- 
chomienie spowoduje wykonanie skryptu. 
W tym celu skorzystamy z Wiersza pole- 


cenia © - znajdujemy go i uruchamiamy. 


Sprawdzamy folder, w którym znajduje 
się plik HelloWorld.java - użyte w po- 
przednim kroku polecenie powinno wyge- 


MH Wiersz polecenia 


Microsoft Windows [Version 168.8.17763.973] 
(c) 2818 Microsoft Corporation. Wszelkie prawa zastrzeżone. 


Przez polecenie ed przechodzimy do 
lokalizacji, w której zapisany został 
plik HelloWoxld java, wpisując ją po ed 


[C: Usersikonra>cd C: NUsersMkonra Documents 


IC : Users lkonraDocuments>javac HelloWworld. java 


Wszystko » - 


Najlepszy wynik 


szl Wiersz polecenia 
Aplikacja 


Ustawienia 
Wiersz polecenia 
© Zamień wiersz polecenia na program > 
Windows PowerShell podczas 
(0 Określ, ile wierszy ma być » 
przewijanych przy użyciu kółka © Owórz 
IE Zarządzaj aliasami wykonywania iii rocka 


aplikacji Otwórz lokalizację pliku 


wyszukaj w sieci Web Przypnij do obszaru startowego 
PD wiersz > © przypnij do paska zadań 
Dokumenty 

o Zaawansowane odzyskiwanie 


z obsługiwane wierszem poleceń.docx 


P wiersz] 
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© *| s | Dokumenty 
< + E Ten komputer > Dokumenty 
EB Pulpit aż 
ram 
4% Pobrane Helloworid.java 
Dokumenty HelloWorid.class 


nerować plik HelloWorld.class l Zawiera 
on instrukcje wykonywane przez maszynę 
wirtualną Javy. 


|C- Wsersykonra (Document s>javac Hel loWor1ld_ java 


|C: XUsers konraDocuments>java HelloWor ld 
Hello world 


IC: Users konraDocuments> 


W Wierszu polecenia wpisujemy teraz 
komendę java HelloWorld ©, by uru- 
chomić plik. 


Wiersz polecenia w odpowiedzi wyko- 
na skrypt - czyli wyświetli tekst Hello 
World ©. 


W ten sposób powstał nasz pierwszy - 
bardzo prosty - program w języku Java! 


Gra liczbowa: mnożenie wylosowanych liczb 


Piszemy skrypt 

W ten sam sposób możemy stworzyć bardziej 
rozbudowany skrypt, który będzie prostą grą 
liczbową, jednak jego napisanie pozwoli na 
poznanie kolejnych instrukcji. Gra będzie 
polegała na podaniu poprawnego wyniku 
mnożenia dwóch liczb wylosowanych przez 
program. Znowu zaczynamy od uruchomie- 
nia Notatnika, by móc pisać nowy skrypt. 


Tak jak w pierwszym projekcie - roz- 

poczniemy od klasy. Wpisujemy public 
class Graf ©. Co ważne, nazwa klasy - 
w tym przypadku Gra - musi być też nazwą 
pliku. Podczas zapisywania pliku musimy 
nazwać go Gra.java. 


public class Graf 


zawrzemy instrukcje do wykonania po uru- 
chomieniu programu. 


Trzecia linia kodu, jaką napiszemy, bę- 

dzie instrukcją, która wykona się jako 
pierwsza w naszym programie. Będzie to 
utworzenie generatora liczb pseudoloso- 
wych (w programowaniu nie ma liczb lo- 
sowych - mamy liczby pseudolosowe, któ- 
rych dobór zależy od pewnych warunków, 
tak by ich wartość była możliwie trudna do 
odgadnięcia). Generator będzie obiektem 
klasy Random. Tworząc obiekt jakiejś kla- 
sy, najpierw podajemy nazwę tej klasy - tu 
Random, potem nazwę obiektu - tu genera- 
tor. Dalej po znaku równości uruchamiamy 
konstruktor, pisząc new Random(). Linię 
kończymy średnikiem. Całość powinna mieć 


public class Graf 


public static void main(String[] args)f 


zatem formę: Random genera- 
tor = new Random(); 


W kolejnej linii kodu powinni] public class Graf 


śmy utworzyć metodę main ©, 
czyli główną metodę klasy, w której 


public static void main(String[] args)( 
Random generator = new Random(); 
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import java.util.Random; 


public class Graf 


public static void main(String[] args)t 
Random generator = new Random(); 


polecenie nextlnt() - gdzie 
w nawiasie możemy podać 
maksymalną możliwą wartość 


Klasa Random nie jest bezpośrednio 
rozpoznawana przez kompilator. Trzeba 


do „wylosowania”. Cała linia 
kodu powinna w tym wypadku mieć postać: 
int x = generator.nextlnt(200); 7.1. 


do skryptu załączyć odpowied- 
nią bibliotekę, w której znajdu- 
je się klasa Random. Biblioteki 
do skryptu załączamy poprzez 
polecenie import - na samym 
początku skryptu. Klasa Ran- 
dom znajduje się w java.util. 


import java.util.Random; 


public class Graf 
public static void main(String[] args)t 


Random generator = new Random(); 
int x = generator.nextInt(200); 
int y = generator.nextInt(200); 


Random. Piszemy zatem import 
java.util.Random; ©. Pamiętajmy: import 
bibliotek umieszcza się na początku skryptu 
- przed definicją klas. 


Teraz już bez obaw, że polecenie nie zo- 

stanie rozpoznane, możemy korzystać 
z obiektu generator. Pozwala on na gene- 
rowanie wartości różnych typów. Załóżmy, 
że chcemy mieć liczbę całkowitą z zakresu 
od 0 do 200. Aby ją przechować, potrzebna 
będzie zmienna. Tworząc nową zmienną, 
najpierw określamy jej typ. Powinien to być 
typ odpowiadający za liczby całkowite, czy- 
li byte, short, int lub long. Nie skorzystamy 
jednak na pewno z typu byte, bo możliwa 
do „wylosowania” wartość przekroczyłaby 
zakres tego typu zmiennej. 200 mieści się 
w zakresie pozostałych typów. Choć maksy- 
malna wartość zmieściłaby się w zmiennej 
typu short, użycie innego typu, na przykład 
int, nie będzie błędem. Po 


Ponieważ w naszym projekcie potrze- 
bujemy dwóch liczb, aby wykonać ich 
mnożenie, tworzymy drugą zmienną, y E] - 
i jej też nadajemy wartość poprzez generator. 


Kolejna linia kodu powinna informować 

użytkownika naszej gry o tym, co powi- 
nien zrobić. Musimy zatem wpisać w konsoli 
informację. Robimy to za pomocą znanego 
nam już polecenia System.out.println(). 
Tym razem jednak już nie będziemy wpisy- 
wać "Hello World”, ale "Podaj wynik mnoże- 
nia”. Użytkownik powinien jednak wiedzieć, 
jakie liczby ma pomnożyć. Jeśli do "Podaj 
wynik mnożenia” dodamy X, to otrzymamy 
ciąg znaków składający się z tekstu w cudzy- 
słowie i wartości zmiennej x. Całe zdanie, 
w którym podajemy działanie do rozwią- 
zania, powinno mieć zatem formę: "Podaj 
wynik mnożenia:”+x+”*”+y 


nazwie typu należy podać 
nazwę zmiennej, na przy- 
kład x. Dalej dajemy znak 
równości, by przypisać do 


int x 


Random generator = 
= generator.nextInt(200); 

int y = generator.nextInt(200); 

System.out.println("Podaj wynik mnożenia: "+x+"*"+y); 


new Random( ); 


zmiennej wartość. Będzie 
ona nadana poprzez generator - a konkret- 
nie poprzez wywołanie jednej z jego me- 
tod. Do generowania liczb w typie int służy 


Dalej użytkownik powinien mieć moż- 
liwość podania odpowiedzi. By móc 
odczytywać dane od użytkownika, będzie 


Random generator = new Random( ); 
int x = generator.nextInt(200); 
int y = generator.nextInt(200); 


Scanner scan = 


System.out.println("Podaj wynik mnożenia:"+x+"*"+y); 


new Scanner(System.in) :ę (System.in); jó 


nam potrzebny obiekt kla- 
sy Scanner, który stworzy- 
my poleceniem Scanner 
scan = new Scanner- 
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import java.util.Scanner; 
import java.util.Random; 


public class Graf 
public static void main(String[] args)£ 
Random generator = new Random(); 
int x = generator.nextInt(200); 
int y = generator.nextInt(280); 
System.out.println("Podaj wynik mnożenia: "+x+"*"+y); 


Scanner scan 


new Scanner(System.in); 


Scanner, podobnie jak Random, nie zo- 
stanie rozpoznany przez kompilator, jeśli 
nie dodamy odpowiedniej biblioteki. Klasa 
Scanner znajduje się w java.util.Scanner 
i by ją importować, przed definicją klasy trzeba 
umieścić linijkę import java.util.Scanner; 
W tym przypadku nie ma znaczenia, która 
z bibliotek będzie importowana jako pierwsza 
(można to zapisać zarówno przed linijką im- 
port java.utilRandom, jak i po niej). 
1 To, co poda użytkownik, będziemy 
musieli przechować w zmiennej. 
Wynik mnożenia dwóch liczb całkowitych 
będzie liczbą całkowitą. Możemy zatem 
użyć typu int. Tworzymy zmienną o nazwie 
odp, typu int. Jako jej wartość przypisujemy 
wywołanie metody nextlnt() © dla obiektu 
asy Ścanner. 


gdy podany przez nas warunek zostanie speł- 
niony (czyli gdy użytkownik udzieli popraw- 


nej odpowiedzi). 
1 Jeśli użytkownik udzieli poprawnej 
odpowiedzi, powinniśmy go o tym 
poinformować - zrobimy to poleceniem 
System.out.println("Dobrze"); | 
if (odp==x*y)f 


System.out.println("Dobrze"); 


if (odp==x*y)f 
System.out.println("Dobrze"); 
) 
1 Jeśli nie chcemy już wykonywać in- 
nych instrukcji, gdy warunek został 


Random generator = new Random(); 
int x = generator.nextInt(200); 
int y = generator.nextInt(200); 


Scanner scan = new Scanner(System.in); 


System.out.println("Podaj wynik mnożenia: "+x+ 


spełniony, możemy zamknąć nawias klam- 
Jeśli chcemy, by coś 


rowy 

1 wykonało się, gdy 
warunek podany w instruk- 
cji warunkowej nie zostanie 
spełniony, musimy dodać 


UEAD 


+y); 


int odp = scan.nextInt(); 
1 Kolejnym krokiem będzie porów- 
nanie podanej przez użytkownika 
liczby z wynikiem mnożenia x iy. Do takich 
porównań używa się instrukcji warunko- 
wej - czyli if. Po tym słowie otwieramy zwy- 
kły nawias, w którym należy wpisać wartość 
wyrażenia, którego poprawność chcemy 
sprawdzić. W naszym wypadku będzie to 
odp==x*y ©. Do porównań używamy 
dwóch znaków równości (jeden 


sekcję else ©, której treść 
(instrukcje do wykonania) także wpiszemy 
w nawias klamrowy. 
if (odp==x*y)f 
System.out.println("Dobrze"); 
) 


lse £ 


znak równości oznacza przypisa- 
nie). Po nawiasie z wpisanym wa- 
runkiem otwieramy nawias klamro- 
wy - to co napiszemy do czasu jego 
zamknięcia, będzie się wykonywać, 


int x 
int y 


System. 
Scanner scan 
int odp = scan.nextInt(); 
if (odp==x*y)f 


1 Analogicznie jak w wypadku udziele- 
nia poprawnej odpowiedzi, gdy użyt- 
Random generator = new Random( ); 


generator.nextInt(200) ; 
generator.nextInt(208); 

out.println("Podaj wynik mnożenia:"+x+"*"+y); 
new Scanner(System.in); 
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kownik udzieli błędnej odpowiedzi, również 
go o tym poinformujemy, a możemy to zrobić 
poleceniem System.out.println("Zle"); 


if (odp==x*y)f 
System.out.println("Dobrze"); 
) 


else £ 


System.out.println("Żle"); 


1 Gi nie chcemy wykonywać więcej 
instrukcji, powinniśmy zamknąć sek- 
cję else nawiasem klamrowym 


if (odp==x*y)f 
System.out.println("Dobrze"); 
) 


else ( 
System.out.println("Źle"); 


) 


1 Chcąc zakończyć definicję głównej 
metody naszej klasy, także zamykamy 
nawias klamrowy 
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1 Podobnie jest z zakończeniem defi- 
nicji całej klasy - też zamykamy ją 
nawiasem klamrowym EJ. 


Kompilacja i uruchomienie 
Podobnie, jak w wypadku Hello World, wy- 
korzystamy Wiersz polecenia do kompilacji 
i uruchomienia programu. 


Poprzez polecenie ed © przenosimy się 
do lokalizacji pliku ze skryptem. 


EH Wiersz polecenia 


Microsoft Windows [Version 10.0.17763.973] 
(c) 2618 Microsoft Corporation. Wszelkie prawą 


[C: Wserskkonra>cd C: WisersykonraDocuments 


Uruchamiamy kompilator javac dla pliku 
Gra.java 


C: Wsersikonra>cd C€: MisersfkonraDocument s 


LC: Wsersykonra Wocuments>javac Gra. java 


Random generator = 
int x = 
Scanner scan = 
if (odp==x*y)t 


) 


else ( 


) 


) 


public static void main(String[] args)t 

new Random( ) ; 
generator.nextInt(280); 

int y = generator.nextInt(280); 
System.out.println("Podaj wynik mnożenia:"+x+"*"+y); 
new Scanner(System.in); 

int odp = scan.nextInt(); 


System.out.println("Dobrze"); 


System.out.println("Źle"); 


public class Graf 
Random generator 


int y 


if (odp==x*y)f 


else £ 


) 


, EJ 


public static void main(String[] args)t 
new Random( ); 
int x = generator.nextInt(200); 

= generator.nextInt(200); 
System.out.println("Podaj wynik mnożenia: "+x+"*"+y); 
Scanner scan = new Scanner(System.in); 
int odp = scan.nextInt(); 


System.out.println("Dobrze"); 


System.out.println("Żle"); 


18 _ JAVAZACZNIJ PROGRAMOWAĆ 


adam1l3zajacigmail.com 


wiersz polecenia 


Microsoft Windows [Version 10.0.17763.973] 
(c) 2818 Microsoft Corporation. Wszelkie prawa zastrzeżone. 


: UsersNkonra>cd C: MUsers)konra Documents 


: NUsersykonraDocuments>javac Gra. java 


: MUsersykonraNDocuments>java Gra 


Następnie poleceniem java Gra © włą- 


czamy program. 


Postępujemy zgodnie z informacjami 


podanymi przez program 6 i podajemy 
wynik. Gra powinna wskazać, czy podany 
wynik jest prawidłowy, czy nie. 


C: MUsersNkonraMDocuments>javac Gra. java 


C: MUserskonraNDocuments>java Gra 
Podaj wynik mnożenia:5A*R 

400 

Dobrze 


C: UsersNkonraMDocuments> 


Wykorzystanie zintegrowanego 
środowiska programistycznego 


W czym wykorzystanie zintegrowanego 
środowiska programistycznego powin- 
no ułatwić pracę? 

Zaprezentowane skrypty to programy działa- 
jące w formie tekstowej. Jeśli myślimy o two- 
rzeniu gier, na pewno chcielibyśmy, by miały 
one okno graficzne. Zintegrowane Środowi- 
ska programistyczne pozwalają na przykład 
na proste generowanie takiego okna poprzez 
moduł graficzny, w którym wygląd programu 
możemy tak naprawdę „wyklikać” - ręcznie 
umieścić w jego oknie choćby przyciski czy 
inne ważne elementy. Gdy brakuje nam ta- 
kiego narzędzia, wszystko trzeba napisać, 
a to może być bardzo czasochłonne. 

Innym ważnym aspektem wykorzystywania 
IDE są biblioteki. Korzystając z klas, do któ- 
rych niezbędny jest import bibliotek, musi- 
my wiedzieć, skąd je brać. IDE potrafi samo 
podpowiedzieć, skąd możemy zaimportować 
bibliotekę. 

Kolejna zaleta zintegrowanych środowisk 
programistycznych to możliwość korzystania 


z podpowiedzi podczas pisania skryptu. Pro- 
gramy te w trakcie pisania sugerują możliwe 
dokończenie instrukcji, co także przyspiesza 
tworzenie. Co więcej, napisane już skrypty 
są często pokolorowane, a dzięki temu - bar- 
dziej czytelne. 

To tylko niektóre z zalet IDE. Jest ich znacz- 
nie więcej. W dalszej części tej książki zapre- 
zentowane zostanie wykorzystanie programu 
Apache NetBeans IDE. 


Tworzenie nowego projektu 
Uruchamiamy Apache NetBeans IDE (II 
KOD: 003 JJ 


By utworzyć nowy projekt, klikamy 
u góry okna na drugi przycisk © od lewej. 


© Apache NetBeans IDE 11.2 


File Edit View Navigate Source Refactor Run De 


Proje[New Project.. (Ctri+Shitt+N) ] 
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Q© New Project x 
W nowym oknie | st» Choose Project 
należy wybrać |; 900 »roject Q Fiter: 
kategorię tworzone- Categories: = 
. Jan Apolkaton a 
go projektu. My na 8 poozrepswece Eryn 
początek będziemy * z Java wt Ant 3 Pozory 
z :. TM was 
korzystać z kategorii "6 zee A Erteronse żgicaton 
. BB Enterorise AoolicaBon Client 
Java with Maven B © somoles $$ 056 Bnde 
W sekcji obok © New Java Application x 
wybieramy typ | se= Name and Location 
projektu Java Appli- | osa aa prajecthame: "ETEUETETEH 
cation , po czym Project Locadon: [€:|Users|konra |Documentz ietBe2nEPrOjecHH |MAveNproj ec BrOWSO... 
przyciskiem Next ProjectFolder: |cekonra CIE NOTRGANEPI OJ ECTS NIENIE OJ CEZ NAWA 
przechodzimy dalej. Artfąct ki sez 
5 Group Ió: €6m.mycompary 
adikota. version: 1.0-5NAPSHOT 
m Java Frontend m Piszą 0OM.MYCOMEANY MA EOPFOJECE (Opoonal) 


W kolejnym kroku możemy podać mię- 

dzy innymi nazwę i lokalizację naszego 
projektu ©. By został utworzony, klikamy na 
Finish. 


Projects x Files _ Services 
-B 
= to Source Packages 
|z| <«om.mycompany.mavenpr oj ec 
+ a Dependencies 
© g Java Dependencies 
+ py Project Files 


Gdy projekt zostanie utworzony, mo- 
żemy rozwinąć jego zawartość - jak na 
ilustracji 


Projects x Files _ Sorvicos = 
=$ meoqeci 
= (b sowcePadaow 


e 


StrtPage X 


+ gp Oeoendecowi "New > Q folder. 
© gg va Droenównow Find. CwieF CJ anel fom. 
zt Moze Cut mx [© Feme[pm. 
Copy QwieC dc 
Ń h A ma?Pacage- 
"a Delete 2] ha Interface. 
Reactor ; © webserceGient. 


Klikamy prawym przyciskiem myszy na 

nazwę paczki utworzonego projektu. 
Z menu kontekstowego rozwijamy pozycję 
New i wybieramy JFrame Form 6. Spowodu- 
je to dodanie do naszego projektu formatki, 
czyli okna graficznego 


He FAA Wew Mawgste Sete Ratacee Fim Debug etle Tam Tool Window Weto 
€ +5 
>Hdv xX>B 5 


Projęcie * Flex 
= $ rawomeai 


O'auk cerą 


$orsicos 
see De wiry 


2 WEG PACZKA 


0-0 W)-5-6: Kia O > 


Sałge X [Bhesknrejpa X 


Q weta centmat moru ta brewna braiabie zaafli HRo0A tey o Aaięcrw CME 


BALIESZFŁLE » $ 


GlB sezstsózw 
(Ż weFarewa 
Desantanswe 


w 
© 8 im Drzednowi 
+ (ę maectkam 


Erze] Nar ga x - 


« ©) pasa 


WIK Serel tur 


EZ) rogyea tur 
|Frzne] . Pregarii 
owi Bea 
= reports 


"EJ" = 
Cody 


SelaszCioseOperation ©XT_ON_ CLOSE 


e 
= Other Prsgertea 
atwaysCn1 09 


alnaysCnTo;tupęortad 


udReguesiF ces 
kaciegicwnt 
teunda 


a 


[2] gj 
T] pt 249 244) 


ZZA 
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StartPage X [Ep New]Framejava X 


Design _ History ARY i 8) 


Source 


y Use the context menu to access availablq 


Jego elementy możemy tworzyć, przecią- 

gając kontrolki na schemat okna z palety 
po prawej stronie okna programu NetBeans. 
Możemy też przełączyć się do trybu teksto- 
wego i zobaczyć skrypt naszego programu. 


KOMENTARZE 


W skrypcie nie wszystkie teksty mają rów- 
norzędne znaczenie dla działania programu. 
Brak niektórych z nich nie wpłynąłby na 
program. Część wygenerowanej treści to 
komentarze. Nie są one brane pod uwagę 
podczas wykonywania skryptów. Komenta- 
rze wykorzystywane są przez programistów 
do zapisywania informacji o fragmentach 
kodu — na przyszłość dla siebie, gdyby 
powrócili do edycji skryptu po przerwie inie 
pamiętali przeznaczenia poszczególnych 
nazw, a także dla innych programistów. 
Komentarz pozwala też oznaczyć fragment 
kodu w ten sposób, by zrezygnować z jego 
działania, jednocześnie nie usuwając 
napisanych już skryptów. Można wtedy, po 
usunięciu oznaczeń komentarza, łatwo przy- 
wrócić go do użycia. Są narzędzia, które na 


Gdy klikniemy na przycisk Source ©, pro- 
gram przeniesie nas do skryptu, który wyge- 
nerował się sam i odpowiada za utworzenie 
okna. Sam wygenerowany skrypt © zajmuje 
ponad 80 linii kodu - co już pokazuje, jak 
pomocne jest wykorzystanie IDE. 

By lepiej zapoznać się z obsługą NetBeans IDE, 
wykonajmy wskazówki z kolejnego rozdziału. 
Dzięki temu poznamy tajniki nie tylko Javy, ale 
i stosowania IDE. 


podstawie komentarzy mogą generować 
dokumentację. Czym jest, jakie znaczenie 
ma dokumentacja i w jaki sposób tworzyć 
komentarze, by pozwalały na jej generowa- 
nie, przeczytamy w dalszej części książki. 
Zwykły komentarz możemy dodać, używając 
dwóch znaków // —- wtedy wszystko, co jest 
napisane po tym oznaczeniu do końca 
linii, jest uważane za komentarz i nie ma 
wpływu na działanie programu. By stworzyć 
komentarz na kilka linijek, zaczynamy go od 
[*, a w miejscu jego zakończenia piszemy */. 
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Tajniki języków programowania najlepiej poznawać, 
tworząc projekty. W tym rozdziale znajdują się instrukcje, 
według których z wykorzystaniem programu NetBeans IDE 
nauczymy się tworzyć grę z oknem graficznym 


Arkanoid — pap nz 


rą graficzną, jaką stworzymy, 

będzie projekt Arkanoid. Roz- 
grywka będzie polegała na takim 
sterowaniu paletką, by odbijać nią 
piłkę, zbijając znajdujące się ponad 
paletką bloczki (cegły). 
Pierwowzór naszej gry został 
stworzony i wydany przez firmę 
Taito w 1986 roku na automaty do 
gry. Do dziś jest to popularny ro- 
dzaj gier, który nieco ewoluował, 
a kolejne wersje są coraz bardziej 
rozbudowane. 
My na początek stworzymy bazę 
do gry, którą poznając tajniki ję- 
zyka Java, będzie można z czasem 
samodzielnie rozbudowywać. 


Efekt - gotowa gra Arkanoid 
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Tworzenie projektu 


Q New Java Application x 


Steps Name and Location 


1. Choose Project 


Project Name: 
2. Name and Location 


ArkanoidKS 


Project Location: (C: Wsers|konra (Documents |NetieansProjects |mavenproject? Browse... 
Project Folder: Usersikonra Documents |NetgcansProj ece |mavenproj ectzArkanordkS 

Artfact Id: Arkanoldk$ 

Group Id: cam.mycompany 

Version: 1.0-SNAPSHOT 

Package: cam.mycompany.arkanoidks (Optional) 


Uruchamiamy program Apache Net- 

Beans IDE i tworzymy 
nowy projekt, tak jak zostało to opisane 
w punktach 1-5 na końcu poprzedniego 
rozdziału. Podczas tworzenia projektu na- 
dajemy mu nazwę odpowiadającą tematyce, 
w naszym przykładzie - ArkanoidKS 


Inaczej niż w poprzednim rozdziale tym 
razem nie dodajemy do naszego projektu 
formatki, czyli JFrame, ale za to umieszcza- 
my w naszym projekcie JPanel Form 


Arkanoióks 
2 h Source Packages 
tel m 

+ » Dependencies | New > (i folder. 

FP g Jama Depender Find... Cwl+F | Java Class... 

4 e PoectFies | z zu 
Cut Grsx  (L) IPanelfom 
Copy Ctrl+C [0 IFrame Form 
Paste Ctrl+V EH) Java Packagi 


Nadajemy mu nazwę PanelGry ©. JPanel 
to płaszczyzna, na której będziemy mogli 
rysować. (Oczywiście poprzez „rysowanie” 
należy rozumieć używanie poleceń, które 
mogą umieszczać na płaszczyźnie kształty). 


Umieścimy na nim figury geometryczne, bu- 
dując w ten sposób wygląd naszej gry. Do- 
piero tę płaszczyznę z figurami umieścimy 
na formatce. To oznacza, że również JFrame 
Form powinien się znaleźć w naszym projek- 
cie. Dlatego klikamy prawym przyciskiem 
myszy na paczkę projektu, gdzie wcześniej 
dodaliśmy JPanel (czyli plik PanelGry.java) 
i tym razem dodajemy JFrame Form 


New sa BG rolder.. 

find_. Ctrl+F [© JFame rm. 

Cut Chi+x | | JPanel Form R 

Copy Ctrl+C Ś) Java Class... 

Paste Ctrl+V =) Jawa Package... 
Nazywamy formatkę Okno ©. Skrypty na- 


szej gry będziemy pisać zatem w dwóch 


O New Jframe Form 


Steps Mame and Locauon 
1. Choose File Type 


Glass tłame: Okno 
2. - Name and Location 


Prajacz Askanoidk$ 


Location: Source Packages 


Packaga: €2M.MyCOMpANY. Arka NOISE 


Created Fi: | nsprojecs mavenorojoccz wia naidksisremaaniy 


Steps Name and Location 
1. Choose File Type Class Name: PanelGnj 
2. Name and Location 
k 
Project ArkanoidKS 
Locaton: Source Packages w 
Package: com.mycompany.arkanoldks u 
Created File: |rojectsimavenprojectzlArkanoidkS |srcimainVava|comimycompanylarkanoidksiPanclGryJava 
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plikach: PanelGry.java - gdzie napi- 
szemy, co ma się wyświetlać na panelu, 
i Okno.java - gdzie napiszemy, aby ten 
panel był integralną częścią okna naszej 


StartPage X |[[) PanelGryjava * [Lp Oknojava X | 


Source 


© me Preview Design button (in the toolbar) enables you to test the design of the form. 


Design Mistry LR [3 | mzBZJ" INE | * $ 


gry. W przypadku tego projektu nie musi- 
my wykorzystywać kontrolek, które widzimy 
w palecie po prawej stronie okna po dodaniu 
formatki. 


Dodane do projektu w poprzednich kro- 
kach pliki są automatycznie otwierane. 


Możemy się między nimi przełączać, klikając 
na zakładki © widoczne nad obszarem edy- 
cji. Zarówno w jednym, jak i drugim pliku 
musimy edytować skrypty - znajdziemy je, 
klikając na przycisk Source © widoczny po 
przejściu do każdego z plików. 


Umieszczanie panelu w oknie gry 


Edycję zaczynamy od pliku PanelGry. 

java. Domyślnie, jak było widać na pod- 
glądzie, JPanel i JFrame mają kolor szary. Jeśli 
nasz panel zmieni kolor tła - to po dodaniu 
go do okna gry i uruchomieniu jej - będzie- 
my widzieć, czy to, co napisaliśmy, zadziałało 
prawidłowo. 


W wygenerowanym automatycznie 

skrypcie panelu znajdujemy jego kon- 
struktor ©, czyli specjalną metodę klasy od- 
powiedzialną za tworzenie obiektów. Gdy 
jest ona wywoływana - powstaje obiekt. 
Zatem umieszczając coś w treści konstruk- 
tora, wiemy, że zostanie to wykonane, gdy 
będziemy tworzyć obiekt. 


public PanelGry() | 


initcomponents () ; 


Dopisujemy do konstruktora polecenie 
setBackground(Color.black); ©. Zmie- 
nia ono kolor tła panelu na czarny. 


18) Ę] public PanelGry() ( 
initcomponents (); 
setRackground (Color.b 


21 ) 


Po jego napisaniu słowo Golor zostaje 
podkreślone na czerwono. W ten spo- 
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sób wykorzystywane przez nas IDE zaznacza 
błędy w kodzie. Sam skrypt jest poprawny, 
jednak brakuje w nim części, która sprawi, 
że słowo Golor będzie zrozumiałe dla pro- 
gramu. Chodzi o import odpowiedniej biblio- 
teki. Tak jak w przykładzie z poprzedniego 
rozdziału, chcąc skorzystać z klas, które wy- 
magają importu biblioteki, należy na począt- 
ku skryptu wpisać słowo import oraz nazwę 
biblioteki. NetBeans IDE może pomóc w im- 
portowaniu odpowiednich bibliotek. 


Przy linijce kodu zawierającej podkreślo- 


ny fragment pojawia się ikona © żarówki 
13 initComponents (); 
% setBackground (Color. 


z czerwoną tarczą z wykrzyknikiem. Klikamy 
na nią, a program wyświetla możliwe rozwią: 
zania wykrytego błędu. Pierwsze w tym przy- 
padku to: Add import for java.awt.Color ©. 
Wybieramy tę opcję. 


public PanelGry() i 
initComponents () ; 


(golor.black) ; 


©. Creote css "Cobr" n pockoge com.mycompany .arkanońdkś (Source Pockoges) 
©. Creste chss"Cobr" n com.mycompany.arkanodks.PanelGry 

© create fiei "Cołbor" n com.mycompany .arkanoiiks.PanelGry 

© Search Dependency at Maven Repostoneś for Cor 


[com mycompany.arkanoxdks.PanelGry > © Panełóry > 
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Import © odpowiedniej biblioteki zosta- 

nie automatycznie dodany do skryptu, 
przed definicją klasy, a po linijce rozpoczy- 
nającej się od słowa package - mówiącej 
o przestrzeni nazw projektu. 


6 package com.mycompany.arkanoidks; 
[i 
p 


-J import java.awt.Color; 


Przechodzimy do pliku Okno.java. 


W nim też odszukujemy konstruktor ©. 
19) E] public Okno() ( 


initCcomponents () z 


ł 


Usuwamy z niego linijkę initCompo- 
nents(); ©, by nic spoza napisanego przez 
nas skryptu nie znalazło się w oknie gry. 


19) Ę] public Okno() ( 


initComponents () z 


ł 


Dopisujemy do konstruktora polecenie 
add(new PanelGry()); ©, które dodaje 
panel do okna. 


1 Przed uruchomieniem NetBeans IDE 

poprosi nas o wskazanie klasy głów- 
nej, czyli tej, której metoda main wykona się 
jako pierwsza po wystartowaniu aplikacji. 
W naszym wypadku będzie to klasa Okno 
- gdyż tylko w niej mamy metodę main. Net- 
Beans pozwala nam jeszcze określić, czy klasę 
główną ustalamy tylko na bieżącą sesję IDE 
(do ponownego uruchomienia narzędzia), 


o 


Available Main Classes : 


com.mycompany.atkanoidks.Okno 


(8) Remember in Current IDE Session 
(0) Remember Permanentiy 


Select Main Class 


Cancel 


czy na stałe ©. Pozostańmy przy domyślnej 
opcji pierwszej. Ostateczne uruchomienie 
programu nastąpi po kliknięciu na przycisk 
Select Main Class 


1 kc zobaczymy okno aplikacji wy- 

pełnione czarnym kolorem ©, to 
oznacza, że wszystko do tej pory zostało na- 
pisane poprawnie. 


public Okno() ( 
add(new PaneclCry()); 


public Okno() (i 
add(new PanelGry ()) 


pack(); 


1 W kolejnej linijce wpisujemy polece- 
nie pack(); ©. Sprawi ono, że wiel- 
kość okna zostanie dopasowana do wielkości 
panelu. A wielkość panelu możemy zmieniać 
zarówno z poziomu skryptu, jak i z poziomu 
edytora graficznego pod opcją Design 


PanelGryjawa X | Oknojava X 


NE 


StartPage X 


Source Design  Wistory -B;8_'H 1 I! | a ja 


|e) The Prewew Design button (in the toolbar) enables you to test the design o 
1 Klikając na Run ©, uruchamiamy 
napisany program, aby przetestować 
działanie stworzonego do tej pory skryptu. 


ż: 


Po zamknięciu okna zwróćmy uwa- 
gę na pasek na dole. Mimo że okno 
tworzonego właśnie Arkanoida zostało zamk- 
nięte, sam program nadal działa w tle. Aby go 
wyłączyć, klikamy na znak x © obok paska 
postępu widocznego u dołu okna NetBeans 


1 


©- 4 W P-EB-G- 


Run (Arkanoidks) | BE G 
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Q Cancel Running Task x 


e 


1 5 Tymczasem program powinien wy- 
łączać się wraz z zamknięciem jego 
okna. By tak się działo, trzeba dodać jeszcze li- 
nijkę: setDefaultCloseOperation(JFrame. 
EXIT ON CLOSE); €. Po tej zmianie, gdy 
uruchomimy program, a potem zamkniemy 
okno, zostanie on całkowicie wyłączony. 


Are you sure you want to cancel Run (ArkanoidKS)? 


Ly LO 


IDE. Następnie zatwierdzamy wyłączenie 
go, klikając na przycisk Yes 
w nowym oknie. Dopiero wte- 
dy program zostanie całkowicie 
wyłączony. 


public Okno() | 
add(new PanelGry()); 
pack (); 
setDefaultCloseOperation(JFrame.EXIT ON CLOSE); 


Dostosowywanie okna gry 


public Okno() i 


dalszej części realizacji 


projektu zobaczymy, jak 
z poziomu skryptu ustalić kon- 
kretną wielkość okna, określoną 


add(new PanelGry()); 

pack () ; 

setbefaultcloseOperation(JFrame.EX1T ON CLOSE); 
setResizable (false) ; 


co do piksela. , 


Najpierw sprawimy, by użytkownik pro- 

gramu nie mógł ręcznie modyfikować 
ustalonej przez nas wielkości. W tym celu trze- 
ba dopisać linijkę setResizable(false); ©- 
Po wprowadzeniu tej zmiany możemy zauwa- 
żyć, że gdy program jest uruchomiony, przy- 
cisk do maksymalizacji okna jest nieaktyw- 
. Nie da się też 
ręcznie zwęzić ani roz- 
szerzyć okna. 


Przechodzimy do PanelGry.java. To 
tu należy określić wymiary, ponieważ 
okno gry dostaje swoje wymiary zależnie 
od wymiarów panelu - wymiary 


je łatwo edytować, gdy zajdzie taka potrzeba, 
bez konieczności wprowadzania zmian w każ- 
dym miejscu kodu, w którym się do nich od- 
nieśliśmy - umieścimy je w dwóch polach. 
Ponieważ nie przewidujemy zmieniania wy- 
miarów okna gry podczas rozgrywki, możemy 
pola te utworzyć jako zmienne finalne, czyli 
takie, którym wartość w skrypcie nadawa- 
na jest tylko raz i nie jest później zmieniana. 
W jednym polu przechowamy szerokość, 
a w drugim wysokość panelu. 

I tak, jeśli chcielibyśmy stworzyć zmienną do 
przechowania szerokości panelu, moglibyśmy 
napisać int OKNO_SZER = 600; E1. 


panelu będą zatem wymiarami 
okna gry. 


public class PanelGry extends javax.swing.JPanel ( 


private final int OKNO_SZER = 600;fJJ 


Wymiary okna będą nam potrzebne do 

dalszego tworzenia skryptów. Od nich za- 
leży choćby to, gdzie na krawędzi okna ma się 
odbijać piłka. By to określić, będziemy musieli 
wykonać kilka działań matematycznych z wy- 
korzystaniem właśnie wymiarów okna. Żeby 
mieć łatwy dostęp do tych wymiarów i móc 
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Jednak jeśli ma to być pole klasy, możemy 

określić jeszcze dostęp. Zgodnie z dobrą 
praktyką pole takie jest uznawane za we- 
wnętrzne, żadna inna klasa nie musi wiedzieć, 
jak ono się nazywa, do czego służy i jaką ma 
wartość. Wystarczy, że wie to tworzący skrypt 
programista i odpowiednio wykorzysta pole 
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- do określenia wymiarów panelu. Dlatego po- 
winniśmy użyć modyfikatora private [E] - pi- 
szemy zatem: private int OKNO_SZER = 600; 


Skoro pole to nie będzie zmieniać war- 
tości, powinniśmy użyć zmiennej final- 
nej. Takich zmiennych używamy właśnie 
w takich wypadkach. Pełna definicja pola, 
któremu nie będzie można 


W tym momencie mamy już pola za- 

wierające docelowe wymiary okna gry, 
które ma mieć 600 pikseli szerokości i 500 
pikseli wysokości. Teraz należałoby skorzy- 
stać z tych pól i przypisać ich wartości do 
wymiarów okna. Zrobimy to, pisząc w kon- 
struktorze: setPreferredSize(new Dimen- 
sion(OKNO_SZER, OKNO_WYS)); 


zmienić wartości w innym 
miejscu skryptu, powinna 
mieć postać: private final 
int OKNO_SZER = 600; [J. , 


setPreferredSize(new Dimension (OKNO_SZER, 


public PanelGry () i 
initComponents (); 


setBackground(Color.black); 


OKNO_WYS) ) ; 


Dobrą praktyką jest, by na- 

zwy zmiennych finalnych pisać wielkimi 
literami. Deklarację takiego pola umieszcza- 
my wewnątrz klasy, ale poza jakąkolwiek jej 
metodą. 


Słowo Dimension nie będzie rozpo- 
znane przez program i zostanie pod- 
kreślone jako błąd. By podkreślenie znikło, 
niezbędne jest dodanie importu odpowied- 
niej biblioteki. Możemy to zrobić ręcznie, 


Podobne pole powinni- 
śmy stworzyć dla wysoko- ję 
ści panelu: private final int „> 
OKNO_WYS = 500; ©. rg 


ILS public class PanelGry 


private final int OKNO SZER = 600; 
private final int OKNO _WYS = 500; 


extends javax.swing.JPanel ( 
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wpisując import java.awt.Dimension; ©, 
lub jak poprzednio (patrz strona 24) - ko- 
rzystając z podpowiedzi programu. Wielkość 
okna powinna zostać odpowiednio ustawio- 
na, gdy gra zostanie uruchomiona. 


package com.mycompany.arkanoidks; 


import java.awt.Color; 


import java.awt.Dimension; 


służy polecenie setTitle(). Ponieważ pa- 
sek tytułowy jest integralną częścią okna 
gry, a nie panelu, polecenia tego używamy 
w pliku Okno.java. Możemy skorzystać 
z niego bezpośrednio w konstruktorze, tak 
jak z innych poleceń używanych wcześniej. 
Tytuł okna wpisujemy w nawiasie polece- 
nia, umieszczając go w cudzysłowie. Całość 
może mieć zatem na przykład taką formę: 
setTitle(”ArkanoidKS"); 


Możemy wprowadzić |Psblie Okno () 


jeszcze jedną modyfi- 
kację okna gry. Na pasku 
tytułowym obecnie nic nie 
ma, a powino być na nim wi- 
dać tytuł gry. Do ustawienia 
napisu na pasku tytułowym 


pack(); 


add(new PanelGry()): 


setDefaultcloseoperation (JFrame.EXIT ON CLOSE); 
setResizable (false); 


sctTitle("ArkanoidKS"); 


t 


Rysowanie na panelu 


paintComponent() - ta metoda jest potrzeb- 
na do rysowania na panelu. Jest już ona 
w klasie JPanel. To co musimy zrobić, to 
zmienić jej treść. Nie będziemy zastępować 
całej treści metody, a jedynie dopisywać do 
niej kolejne instrukcje. 


Wewnątrz klasy PanelGry, a pod definicją 

konstruktora wpisujemy ©Override 
oznacza, że następna opisana metoda zostaje 
nadpisana. Metoda ta musi istnieć w klasie 
bazowej, po której dziedziczy nasza klasa. 
Tak jest właśnie w tym przykładzie. 


obiekt g klasy Graphics. W tym wypadku 
nie musimy tworzyć tego obiektu w naszej 
klasie i deklarować go jako kolejnego pola. 
Możemy za to wewnątrz metody paintCom- 
ponent wywoływać jego metody - te z kolei 
pozwalają na rysowanie różnych kształtów, 
co jest naszym celem. 


8 5] import java.awt.color; 
5 import java.awt.Dimension; 
0 import java.awt.Graphics; 


Program nie rozumie jeszcze słowa Gra- 
phics, co możemy zmienić, importując 
odpowiednią bibliotekę. 


setBackground (Color.black) ; 


, 


QGOverride 


publice void paintComponent (Graphics g) ( 


setPreferredSize (new Dimension (OKNO_SZER, OKNO_WYS)); 


W tym wypadku można 
to zrobić, pisząc import 
java.awt.Graphics; 


By nie utracić do- 


W kolejnej linii piszemy public void 
paintComponent(Graphics 5) f 6, co 
oznacza odniesienie do publicznej metody 
paintComponent, która za parametr bierze 
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tychczasowej defi- 
nicji metody, możemy rozpocząć jej nową 
definicję od zawartości starej definicji. Zro- 
bimy to, wywołując metodę poprzez jej na- 
zwę poprzedzoną słowem super - całość 
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powinna mieć następującą postać: super. 
paintComponent (g); 


Goverride 
public void painLComponent (Graphics q) 
super.paintComponent (g) ; 


Ponieważ paintComponent() jest meto- 

dą publiczną, dobra praktyka wymaga, 
by nie opisywać bezpośrednio w niej ry- 
sowania wszystkich elementów okna gry, 
ale stworzyć w tym celu metodę prywat- 
ną. Zatem wewnątrz nadpisywanej meto- 
dy wywołujemy nową metodę poleceniem 
rysuj (5) ; ©, a poniżej tworzymy definicję 
nowej metody rysuj poprzez polecenie 
private void rysuj(Graphics g) 


QGOverride 

publie void paintComponent (Graphics g) ( 
super.paintcomponent (g) ; 
rysuj (g); 

l 


private void rysuj(Graphics g) ( 


U 


Chcąc narysować prostokąt, musimy 


kąt oddalony od prawej krawędzi o 100 pik- 
seli, a od górnej krawędzi okna o 200 pikseli, 
o szerokości 300 pikseli i wysokości 250 pik- 
seli, należy użyć polecenia g.fillRect(100, 
200, 300, 250); 


private void rysuj(Graphics g) 4 
g.fillRect(100, 200, 300, 250); 


By prostokąt ten miał inny niż domyślny, 
szary kolor, trzeba zastosować polece- 
nie g.setColor(Color.red); ©. Polecenie to 
zmienia kolor rysowania na czerwony (moż- 


private void rysuj (Graphics g) | 
g.setColor (Color.red); 
200, 300, 


g.fillRect (100, 250); 


, 


na też zastosować inne kolory, podając ich 
angielskie nazwy). 

Co ważne, polecenia tego trzeba użyć przed 
poleceniem rysowania, można to sobie wy- 
tłumaczyć tak, że najpierw wybieramy farby, 
a potem nimi malujemy. 


Gdy uruchomimy program po wprowa- 
dzeniu opisanych zmian, w oknie powi- 
nien pojawić się czerwony prostokąt 


dla obiektu g wywołać po- 
lecenie fillRect lub polecenie 
drawRect. Rysują one różne 
prostokąty, pierwsze z nich two- 
rzy prostokąt wypełniony kolo- 
rem, drugie zaś - tylko kontur 
prostokąta. W jednym i drugim 
poleceniu prostokąt rysowany 
jest na podstawie liczb poda- 
nych w nawiasie. Należy podać 
cztery liczby. Pierwsza z nich 
to odległość prostokąta od le- 
wej krawędzi panelu, a druga 
to odległość prostokąta od gór- 
nej krawędzi panelu, trzecia 
to szerokość figury, a czwarta 
- wysokość. 
Zatem, by narysować całkowi- 
cie wypełniony kolorem prosto- 


Ś: Arkanoidk5 
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Tworzenie paletki 


poprzedniej części rozdziału stwo- Następnie stworzymy pola xp i yp. Po- 
rzyliśmy prostokąt. Teraz utrwalimy służą one do określenia współrzędnych x 
sobie to, czego się nauczyliśmy, i za pomocą  iy paletki. Współrzędne te inaczej określamy 
poznanych poleceń stworzymy paletkę. Za- jako odległości odpowiednio od lewej krawę- 
równo jej położenie w oknie gry, jak iwymia- dzi okna i od górnej krawędzi okna. 
ry powinny być określone nazwami, tak by 
później nie było kłopotu z ich odczytaniem. Polu xp należy nadać taką wartość, by 
Niektóre z wartości będą się zmieniać, jak na narysowana już paletka znajdowała się 
przykład odległość paletki od lewej krawędzi idealnie na środku okna, czyli by jej odleg- 
(na tym polega ruch paletki), a inne będzie  łość zarówno od lewej, jak i prawej krawę- 
trzeba odczytać choćby po to, by sprawdzić, _ dzi okna była taka sama. Ten efekt uzyskamy, 
czy poruszająca się po oknie gry piłka trafiła _ gdy od szerokości okna (panelu) odejmiemy 
w paletkę i powinna się od niej odbić. szerokość paletki i podzielimy wynik przez 
dwa. Dlatego deklarujemy pole linią private 
Tworzenie paletki rozpoczniemy od de- _ int xp = (OKNO_SZER- szerPaletki) / 2; e. 
klaracji pól klasy, których wartości wy. _ Nawet jeżeli wynik działania nie będzie 
korzystamy do narysowania paletki, poprzez liczbą całkowitą, część ułamkowa zostanie 
private int szerPaletki = 100; ©. Tego pola _ odcięta. 


nie tworzymy jako finalnego, po- 
R W y y Ja AR 8 , p public class PanelGry extends javax.swing.JPanel (| 
niewaz rozważając różne warianty 
rozbudowy STY, mozemy zechcieć private final int OKNO_SZER = 600; 
zwiększyć poziom trudności roz- private final int OKNO_WYS — 500; 
grywki poprzez zmniejszanie pa- privata int szerpalerki = 100; 
letki. A wtedy pole szerPaletki private int wysPaletki = 10; 
będzie wymagało zmienienia jego private int xp — (OKNO SZER — szerPaletki) / 2; 
wartości. 


Pole yp musi dostać taką wartość, 
by paletka swoją dolną krawędzią 
private final int OKNO SZER = 600; dotykała dolnej krawędzi okna. Zatem 
private final int OKNO WYS = 500; odległość paletki od górnej krawędzi 
private int szerPaletki = 100; okna można obliczyć, odejmując od 
wysokości okna (panelu) wysokość 
Podobnie powinniśmy postąpić z po- paletki. Deklaracji dokonujemy linią: private 
lem do przechowywania wysokości int yp= OKNO_WYS - wysPaletki; ©. 
paletki, które również tworzy- 
my jako liczbę całkowitą poprzez 
private int wysPaletki = 10; 
Nasza przykładowa paletka ma mieć 10 pik- Teraz możemy skorzystać z wartości tych 
seli wysokości, jednak możemy dowolnie pól do narysowania prostokąta będące- 
modyfikować jej wymiary, umieszczając go paletką. Mamy już utworzoną metodę 
w kodzie inne wartości dla tworzonych pól. rysuj. Dla zachowania przejrzystości kodu 
rysowanie poszczególnych elementów gry 
powinno być umieszczone w specjalnie dla 
nich stworzonych metodach, a metoda rysuj 
powinna być odpowiedzialna za zbiorowe 


public class PanelGry cxtends javax.swing.JPanel ( 


private int xp = (OKNO_SZER - szerPaletki) / 2; 
private int yp = OKNO_WYS - wysPaletki; 


private final int OKNO_SZER = 600; 
private final int OKNO _WYS — 500; 
private int szerPaletki = 100; 


private int wysPaletki = 10; 
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private void rysuj(Graphics g) ( 
g.setcolor(Color.reci) ; 
g.tillRect (100, 200, 300, 250); 

ł 

private void rysujPaletke (Graphics q) i 


> 


wywołanie wszystkich pozostałych metod 
dotyczących rysowania. W takim wypadku 
należy stworzyć metodę rysujPaletke() ©; 
ajej wywołanie umieścić w metodzie rysuj ©, 
jednocześnie pozbywając się instrukcji od- 
powiedzialnych za rysowanie testowego 
prostokąta. 


private void rysuj (Graphics g) ( 
rysujPaletke(g); 
ł 


private void rysujPaletke (Graphics g) f 


Treść metody rysujPaletke powinna 
rozpoczynać się od wyboru jej koloru. 
W naszym przykładzie paletka ma być 
czerwona z białą obwódką. Zaczniemy od 


g" teraz uruchomimy program, zoba- 
czymy, że u dołu okna jest już widoczna 
paletka ©. Nie jest ona jednak jeszcze w peł- 
ni zgodna z założeniami - brakuje jej białej 


obwódki. 

1 W kolejnej linii kodu należy zatem 
ustawić kolor rysowania na biały 

g.setColor(Color.white); 


koloru wypełnienia - poprzez po- 
lecenie g.setColor(Color.red); 
ustawiamy kolor rysowania na 


private 


g.se 
g.fi 
g.se 


void rysujPaletke (Graphics g) 
tColor (Color.red) ; 
llkRect (xp, yp, szerpaletki, wysPaletki); 


( 


czerwony. 


private void rysuj (Graphics g) ( 
rysujPaletke(g); 

, 

private void rysujPaletke (Graphics q) 

g.setColor (Color.red); 


t 


tColor (Color.white); 

1 Następnie, aby stworzyć obwódkę 
prostokąta, zamiast polecenia fill- 

Rect użyjemy polecenia drawRect (z tymi 

samymi parametrami). Zatem należy napisać: 

g.drawRect(xp, yp, szerPaletki, wysPa- 

letki); 


W kolejnej linii należy użyć pole- 
cenia g.fillRect, jednak inaczej niż 


SEE g- 
w wypadku wcześniej rysowanego eq 
prostokąta w nawiasie po poleceniu g. 
nie wpisujemy liczb, lecz nazwy pól, g. 


z których wartości zostaną wykorzy- 


private void rysujPaletke (Graphics g) 


i 
setColor(Color.reci) ; 

fillRect (xp, YD, 
setColor (Color.white); 


YP: 


szerPaletki, wysPaletki):; 


drawRect (xp, szerPaletki, wysPaletki); 


stane przez polecenie. Należy zatem 
wpisać: g.fillRect(xp, yp, szerPaletki, 
wysPaletki); 


Po uruchomieniu programu zobaczy- 
my, że paletka ma białą obwódkę 


1 


private void rysujPaletke (Graphics g) 
g.setColor (Color.red); 


t 


g.fillRect (xp, yp, SszerPaletki, wysPaletki) ; 
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Ę posób tworzenia piłki jest bat- | private 
dzo podobny do tworzenia | private 
paletki. Najpierw należy zadekla- | private 
rować odpowiednie pola, a póź- | private 
niej skorzystać z nich w metodzie |Pżv=*e 
odpowiedzialnej za rysowanie piłki | 77-737 

rivate 


i zadbać o jej wywołanie, by rysu- 
nek faktycznie pojawił się w oknie gry. 


Piłka w przeciwieństwie do paletki jest 
okrągła, zatem do określenia jej wielko- 
ści wystarczy jeden wymiar, czyli jej śred- 
nica. Do przechowania tej wielkości może- 
my stworzyć pole srednicaPilki © i nadać 
mu odpowiednią 


final int OKNO_SZER — 600; 

int OKNO_WYS 500; 

szerPaletki = 100; 

wysPaletki — 10; 

xp (OKNO_SZER - szerPaletki) / 2. 
YP OKNO_WYS — wysPaletki; 
srednicaPilki 20; 


tinal 
int 
int 
int 
int 


1nt 

3 Podobnie będzie z obliczeniem odległo- 
Ści piłki od górnej krawędzi okna, jed- 

nak tym razem zamiast szerokości okna do 

obliczeń należy wykorzystać jego wysokość. 

Linia kodu z deklaracją pola powinna zatem 

wyglądać tak: private int yPilki = (OKNO_ 

WYS - srednicaPilki) / 2; 


wartość, na przy- final int 


kład 20. 


private 
private final int 


privale inL 


szerPaleLki — 100; 


OKNO_SZER = 600; 
OKNO_WYS = 500; 


32 


Do narysowa- private int wysPaletki = 10; 
nia piłki będą private int xp = (OKNO SZER — szerPaletki) / Ż; 
jeszcze potrzebne private int yp = OKNO_WYS - wysPaletki; 
jej współrzędne x private int srednicaPilki = 20; 
iy, czyli odległości private int xPilki = (OKNO _SZER — srednicaPilki) / 2; 
od krawędzi okna. private int ypilki = (OKNO _ WYS — srednicaPilki) / 2; 
private final int OKNO SZER = 600; jk 
private final int OKNO_WYS = 500; Mamy już zadeklarowa- 
private int ŚZGŁDZJACEJ = 100: „ne pola, ale żeby móc 
private int wysPalotki — 10; Z nich skorzystać, należy 
privale inL xp — (OKNO _SZER — szerPaleLki) / 2; stworzyć metodę przezna 
private int yp = OKNO WYS -— wyskaletki; czoną do rysowania piłki. 
private int srednicaPilki = 20; Może się nazywać rysujPil- 
private int xPilki = (OKNO SZER — srednicaPilki) / 2; z 
Odległość od lewej krawędzi okna | 7 private void rysufPilke (Graphics q) i 


można zapisać jako xPilki. Aby piłka l 
znajdowała się idealnie na środku 


okna gry, trzeba dokonać podobnych ob- 
liczeń, jak w przypadku odległości paletki 
od lewej krawędzi okna, jednak w tym wy- 
padku od szerokości panelu należy odjąć 
szerokość piłki, czyli jej średnicę, a wynik 
podzielić przez 2. 

Zatem deklaracja współrzędnej x dla piłki 
powinna mieć postać: private int xPilki = 
(OKNO_SZER - srednicaPilki) / 2; 
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Treść tej metody w naszym przykładzie 

będzie się zaczynać od wyboru koloru. 
Można przyjąć, że piłka tak jak paletka będzie 
czerwona z białą obwódką. I tu podobnie jak 
w wypadku paletki zaczynamy od wyboru 
koloru wypełnienia - g.setColor(Color. 
red); 


private void rysnjPilka(Graphics g) ( 


g.setColor (Color.red); 
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W. kolejnej linii 
użyjemy polecenia 


fillOval, które działa ; 


private void rysujPilke (Graphics g) ( 
g.setColor (Color.red) ; 
[Jo.fi110va1 (xPilki, yPilki, srednicapPilki, srednicapilki); 


bardzo podobnie do 


fillRect, tyle że wypeł- private void rysujPilke (Graphics g) i 


nia owal, a nie prosto- g.setColor (Color.red) ; 
kąt. Aowalo tej samej g.tillOval(xPilki, yPilki, srednicaPilki, srednicaPilki); 
szerokości i wysokości g.setColor (Color.wiite) A B | 


da nam koło. Dlatego L! 


należy napisać 8.fil- private void rysujPilke (Graphics g) ( 


IOval(xPilki, yPilki, g.setColor (Color.red); 
srednicaPilki, sred- g.tillOval(xPilki, yPilki, srednicaPilki, srednicaPilki); 
nicaPilki); LJ. .setcolor (Color.white) ; 


g 
[M 1.drawoval(xPilki, yPilki, srednicaPilki, srednicaPilki); 


Następnie wybie- U 
ramy biały jako kolor obwód- 


ki - g.setColor(Color.white); [3]. |* "5795 


Obwódkę tworzymy pole- 

ceniem g.drawOval(xPilki, 
yPilki, srednicaPilki, srednica- 
Pilki); [3. 


Tak zdefiniowaną metodę na- 
leży wywołać © w zbiorczej 
metodzie rysuj. 


private void rysuj(Graphics g) 
rysujPaletke (g) ; 
rysujPilke(g):; 


1 Po uruchomieniu progra- 
mu na środku okna gry 
zobaczymy piłkę 


Tworzenie cegieł 


M amy już narysowane paletkę i piłkę, 
ostatnim elementem graficznym, któ- 
ry jest nam potrzebny do stworzenia gry, są 
bloki (cegły), które będą w tej grze zbijane. 


Żeby zająć się rysowaniem cegieł, nie- 
zbędne jest określenie ich liczby. Cegły 


powinny być ułożone regularnie, w określo- 
nej liczbie kolumn i wierszy. Aby gra była 
bardziej nieprzewidywalna, liczba kolumn 
i wierszy może przyjąć wartość pseudoloso- 
wą. A żeby taką wartość uzyskać, niezbędne 
jest stworzenie obiektu klasy Random peł- 
niącego funkcję generatora liczb pseudoloso- 
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wych. Należy zatem napisać: private final int OKNO_SZER = 600; 
private Random generator | vrivate Cinal int OKNO WYS — 500; 
= new Random(); private int szerPaletki = 100; 
private int wysPaletki = 10; 
By klasa Random była pozeace BE xp = (OKNO_SZER — PAZPARCEJ r2ż 
rozpoznana przez pro- poysce say yp = p = s e odżowięcc 
= private int s i = 20%; 
gram, trzeba dokonać impor- private int = (OKNO SZER - srednicaPilki) / 2; 
tu biblioteki: import java. private int yPilki = (OKNO_WYS - srednicapilki) / 2; 
util.Random; private Random generator — new Random() ; 
8| [7] import java.awt.Color; private int szerCegla = 50; ©. Określając 
3 import java.awt.Dimension; szerokość cegły, warto mieć na uwadze to, 
JĄ | 35port java.awt.Graphics> jaka jest maksymalna liczba kolumn i jaka jest 
|M| import java.util.Random; szerokość okna. Szerokość cegły pomnożona 
x rivate 1nt yFllK1 = (UKNU wI5 — sreanlCaPl1K1) / 4 
Aby skorzystać Z tego "RPO Random posia <a Random () ; i 
generatora, należy private int wiersze = generator.nextInt (5) + 4; 
utworzyć pole reprezen- private int kolumny = generator.nextInt(5) + 4; 


tujące liczbę kolumn, private 


int szercegla = 50; 
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w jakich mają być ułożo- 
ne cegły, a także pole reprezentujące liczbę 
ich wierszy. Wartość tych pól powinna być 
nadana poprzez polecenie nextlnt. Przyj- 
mijmy, że liczba wierszy i kolumn powinna 
mieścić się w zakresie 4-8. Polecenie nextlnt 
pozwala jedynie na określenie górnej grani- 
cy generowania liczby. Można sobie z tym 
poradzić - wystarczy wygenerować liczbę 
w zakresie do 5 © jest wartością graniczną 
- ale nie może zostać wygenerowana, ge- 
nerowana jest „liczba mniejsza od 5”) i do 
tej wygenerowanej liczby dodać 4. Wtedy 
otrzymamy liczbę z oczekiwanego przez nas 
zakresu. Definicja pola do przechowywania 
liczby kolumn powinna mieć postać private 
int kolumny = generator.nextlnt(5) + 4;, 
a do liczby wierszy private int wiersze = 
generator.nextlnt(5) + 4; 


przez liczbę kolumn (maksymalną) - w tym 
wypadku 8+:50 = 400 - powinna być mniejsza 
niż szerokość okna - w tym wypadku 500. 
Różnica pomiędzy tymi wartościami musi 
być na tyle duża, by zmieściły się też odstępy 
pomiędzy cegłami. Dlatego po zadeklarowa- 
niu wysokości cegieł (linia: private int wys- 
Cegla = 10; ©) należy zająć się deklaracją 
odstępów pomiędzy tymi cegłami. 


private int szerCegla = 50; 
private int wyscegla = 10; 


Możemy wyróżnić przynajmniej dwa 
rodzaje odstępów: jeden to odległość 
pomiędzy kolumnami, a drugi to odległość 
między wierszami. A warto także pamię- 
tać o odległości pierwszej kolumny cegieł 


od lewej krawędzi okna 


ILvaLE LIL yFLLKL — (UNNU _WID — SLIEUIICdFLLANL) / £; . Ek" . 
pó — "| 1 odległości pierwszego 
private Random generator = new Random(); 5 5 B ; 
. . . maz wiersza cegieł od górnej 
private int wiersze = generator.nextInt(5) + 4; . A 
: ł e a krawędzi okna. Zacznie- 
private int kolumny = generator.nextInt(5) I 4; 


Każda cegła powinna być taka sama, 
więc wszystkie mają mieć identyczną 
szerokość i wysokość. By tak się stało, ich 
wymiary powinny również trafić do pól 
klasy. Należy zatem stworzyć linię kodu: 
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my od odległości między 
cegłami. Możemy uznać, że zarówno między 
kolumnami, jak i między wierszami może 
być taka sama odległość. 
Aby ją określić, deklarujemy pole private 
int ceglyOdstep = 5; []. 
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private int kolumny — generator.nextInt(5) + 4; 


private int szerCegla = 50; dzielne pole dla jej współrzędnej y. Po 
private int wysCegla = 10; dwa pola dla każdej z maksymalnie 64 


private int ceglyodstep = 5;[J cegieł - to razem byłoby 128 pól. To 


zdecydowanie nie byłoby dobre roz- 

Następnie można określić odstęp pierw- wiązanie. Na szczęście z pomocą przycho- 

szej kolumny od lewej krawędzi okna. dzą nam tablice. Przypominają one zmienne, 
Ta odległość powinna być taka sama jak jednak pozwalają przechowywać pod jedną 
odległość ostatniej kolumny od prawej kra- nazwą więcej różnych ponumerowanych 
wędzi okna. By obliczyć ten odstęp, należy _ wartości. Tablice mogą być wielowymiaro- 
policzyć całą szerokość dużego prostokąta, we, na przykład dwuwymiarowe. Wtedy 
który budują wszystkie cegły. Będzie ona każda wartość w takiej tablicy ukrywa się 
równa sumie szerokości wszystkich kolumn, nie pod jednym numerem, ale pod dwoma. 
do której powinny zostać dodane wszystkie I takie rozwiązanie będzie dla nas przydat- 
odstępy między kolumnami. A odstępów ne. Skorzystamy z tablic dwuwymiarowych 
tych jest zawsze o jeden mniej niż kolumn. do przechowywania współrzędnych cegieł. 
Taką wspólną szerokość cegieł należy odjąć _ Każda cegła będzie identyfikowana numerem 
od szerokości okna - a wynik podzielić przez _ kolumny i wiersza, w których się znajduje. 
dwa. Pole powstałe w wyniku polecenia pri- _ Stworzenie tablicy o nazwie ceglyX do prze- 
vate int ceglyOdstepLewa = (OKNO_SZER  chowywania współrzędnych x wszystkich 
-(szerCegla*kolumny + ceglyOdstep*(ko- cegieł wymaga napisania linii: private int 
lumny-1))) / 2; € będzie zawierać taką odleg-  ceglyX[][] = new int[kolumny][wiersze]; E]. 
łość od krawędzi, jakiej poszukujemy. Liczba kwadratowych nawiasów po nazwie 


private Random generator = new Random(); 
private int wiersze = generator.nextInt(5) + 4; 
private int kolumny = genecerator.noxtlnt(5) + 4; 
private int szerCegla = SU; 

private int wyscCegla = 10; 

private int coglyOdstop — $; 


5 


private int ceglyOdstepTlewa = (OKNO_SZFR - (szerCegla*kolumny + ceglyOdstep*(kolumny-1))) / 2; 


E 


private int ceglyOdstep = 5; 
private int ceglyOdstepLewa = (OKNO_SZER (szerCegla*kolumny + ceglyOdstep* (kolumny-1))) / 2; 


private int coglaodstopcora — 10;| 


Ostatni z odstępów to odległość pomię- 

dzy pierwszym wierszem cegieł a górną 
krawędzią okna. Ta wielkość nie musi wy- 
nikać z obliczeń i może być ustalona przez 
programistę, na przykład w formie: private 
int ceglaOdstepGora = 10; ©. 


tablicy mówi o liczbie jej wymiarów. War- 
tości wpisane w kwadratowe nawiasy po 
typie danych mówią o maksymalnej liczbie 
elementów tablicy. A liczba ta wynika z licz- 
by kolumn i wierszy. Opisana w tym punkcie 
linia kodu tworzy jedynie tablice - konkretne 
wartości zostaną w tej tablicy umieszczone 
Kolejną ważną rzeczą jest lokalizacja _ w dalszych krokach. 
cegieł. Każda cegła będzie miała inną 
lokalizację. Nie oznacza to jednak, że dla Analogicznie do tablicy służącej do prze- 
każdej cegły należy tworzyć oddzielne pole chowywania współrzędnych x wszyst- 
do przechowywania jej współrzędnej xiod- kich cegieł należałoby stworzyć odpowiednią 


private int ceglyOdstepLewa = (OKNO SZER - (szerCegla*kolumny + ceglyOdstep*(kolumny-1))) / 2 
private int ceglaOdstepGora = 10; 
private int ceglyx(](] = new int(kolumny] (wiersze) ; [EJ 


JAVA ZACZNIJ PROGRAMOWAĆ 


35 


| adam1i3zajacEgmai1.com 
Java w praktyce 


36 


public PanelGry() 
initcomponents (); 
setBackqround(Color.black); 


' A 23 (int i — 0; i < kolumny; i++) 
[g 591vy*031 [3] 
[[<e91v"11] (3) 

EL 


| FL 


ł 


setPreferredSize (new Dimension (OKNO_SZER, OKNO _WYS)); 


Ejtor (int j = ; j X wiersze; j+4) ( 
i * (szerCegla + ceglyOdsten) + ceglyOdstepT awa; 
j * (wyscegla + ceglyodstep) + ceglaodstepGora; 


( 


tablicę do przechowywania współrzędnych y 
wszystkich cegieł. Można to zrobić w ten spo- 
sób: private int ceglyY[][] = new int[kolum- 
nyj[wiersze]; Ją 


Powinno ono wyglądać następująco: 

EJ - pętla for, która wykona się dla każdej 
kolumny; 

EJ - pętla for, która wykona się dla każde- 


II 


private int ceglyx[][] 


II 


new int[kolumny] [wiersze]; 


new int[kolumny] [wiersze]; 


go wiersza w kolum- 
nie; pętla w pętli - 
w ten sposób poprzez 


private int ceglyY[][] 
1 Nadając wartości poszczególnym 
elementom tablic stworzonych w po- 
przednich krokach, trzeba odnosić się do 
każdego z nich z osobna. Czy będzie to wy- 
magało napisania 128 linii kodu, po jednej 
dla każdej wartości? Na szczęście nie, a to 
dzięki temu, że mamy do dyspozycji pętle, 
czyli konstrukcje pozwalające wielokrotnie 
wykonywać instrukcje. W tym wypadku 
pomocna okaże się pętla for. Pozwala ona 
na wykonanie wybranych instrukcji okre- 
śloną liczbę razy i ma następującą składnię: 
for (int i = 0; i < kolumny; i++)  zapętlone 
instrukcje ), gdzie: 
m int i = 0 - oznacza deklarację zmiennej i, 
która iterując, zmienia swoją wartość; moż- 
na w tej pętli korzystać z wartości zmiennej 
tworzonej na potrzeby pętli; 
m i < kolumny - oznacza warunek wykony- 
wania pętli, w tym wypadku zmienna i musi 
mieć wartość mniejszą niż zmienna kolum- 
ny. W przeciwnym wypadku wykonywanie 
instrukcji z pętli zostanie zakończone; 
m i++ - oznacza sposób zmiany wartości 
zmiennej i z każdym przejściem pętli; zapis 
ten jest tożsamy z zapisem i = i+1. 
Nadanie wartości elementom tablicy nale- 
ży wpisać w konstruktorze klasy PanelGry. 
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zmienne i i j może- 
my odnieść się do każdej cegły i opisać jej 
lokalizację; 
[FH - przypisanie wartości współrzędnej x 
dla elementu tablicy określonego numerami 
[iJ[J]. Działanie i * (szerCegla + ceglyOd- 
step) + ceglyOdstepLewa to wzór na ob- 
liczenie odległości poszczególnych cegieł 
od lewego brzegu okna. Dla pierwszej ko- 
lumny odległość jest taka sama jak wartość 
ceglyOdstepLewa, dlatego że i w pierw- 
szym przejściu pętli jest równe zeru; dla 
każdej kolejnej kolumny odległość ta jest 
większa o szerokość cegły oraz odstęp po 
tej kolumnie; 
[] - przypisanie wartości współrzędnej y 
dla elementu tablicy określonego numerami 
[IID]. Działanie j * (wysCegla + ceglyOd- 
step) + ceglaOdstepGora to wzór na ob- 
liczenie odległości poszczególnych cegieł 
od górnej krawędzi okna; dla pierwszego 
wiersza odległość jest taka sama jak wartość 
ceglaOdstepGora, dlatego że j w pierwszym 
przejściu pętli jest równe zeru. Dla każdego 
kolejnego wiersza odległość ta jest większa 
o wysokość cegły oraz odstęp po kolejnym 
wierszu; 
E - zamknięcie wewnętrznej pętli for; 
[i - zamknięcie treści zewnętrznej pętli for. 
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1 Gdy współrzędne cegieł są już obli- 

czone i zapisane w tablicach, można 
przejść do rysowania cegieł. W tym celu nale- 
ży zdefiniować nową metodę - rysujCegly ©. 


private void rysujcegly (Graphics g) ( 


1 Obliczając współrzędne każdej z ce- 
gieł, by się do niej odnieść, stosuje- 
my dwie pętle for - jedna w drugiej - w taki 
sposób, by zmienne tworzone na potrzeby 
pętli odpowiadały numerom cegieł w dwóch 
wymiarach tablicy. Rysując cegły, znów nale- 
ży się odnieść do każdej z nich. To oznacza 
ponowne zastosowanie pętli for. Pierwsza 
z nich - for (int i = 0; i < kolumny; i++) ) 
wykona się tyle razy, ile jest kolumn. 


private void rysujCegly (Graphics q) (I 


for (int i = 0; i < kolumny; i++) ( 


1 Druga z pętli powinna znajdować się 
wewnątrz pierwszej i wykonać się 
tyle razy, ile mamy wierszy - for (int j = 0; 


j < wiersze; j++)[ ) 

1 Wewnątrz wewnętrznej pętli możli- 
we jest już odnoszenie się do kolej- 

nych elementów dwuwymiarowych tablic. 


private void rysujcegly (Graphics g) i 


for (int i = 0; i < kolumny; i+ł) ( 


, 


» T 


for (int j = 0; j 4 wiersze; j++) 


t 


Należy je wykorzystać w poleceniu rysują- 
cym prostokąt. A zanim prostokąt zostanie 
narysowany, trzeba wybrać jego kolor. 

W naszym przykładzie cegły będą czerwo- 
nymi prostokątami z białymi obwódkami. 
Podobnie jak w przypadku poprzednich 
metod odpowiedzialnych za rysowanie za- 
czniemy od wyboru koloru wypełnienia - 
g.setColor(Color.red); 


private void rysujCegly (Graphics g) ( 
for (int i = 0; i < kolumny; iłł) I 
for (int j — 0; j << 
g.setColor(Color.red) ; 


wiersze; j++) 


1 Kolejna linia kodu to rysowanie pro- 
stokąta. W poleceniu fillRect należy 

użyć wartości współrzędnych przechowy- 

wanych w tablicach. 

Cała linia kodu powinna mieć formę: g.fill- 

Rect(ceglyX[i][j], ceglyY[i][J], szerCegla, 

wysCegla); 


1 6 Kolejny krok to wybór białego jako 
koloru obwódki - g.setColor(Color. 
white); 


private void rysnjcegly(Graphics g) i 


for (int I = 0; i < kolumny; i++) 
for (int j = 0; j < wiersze; j 


g.setColor (Color.red) ; 


g.fillRecr(ceglyx[i][j], ceglyY[i][(j]., szercegla, wyscegla): 


( 
4) ( 


private void rysujCegly (Graphics g) | 

for (int i = 0; i < kolumny; i++) 
(int j = 0; | X wiersze 
g.setColor (Color.rcd); 


for 


g.tillRect(ceglyX[i] [j 


i++) ( 


q.setColor(Color.white); 


t 


], ceglyY[i]l[j], szerCegla, wysCegla) 
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private void rysujcegly(Graphics g) 
for (int i = 0; i < kolumny; i++) 


for (int j 0; j < 


wiersze; jtt) ( 
g.setColor (Color.red) ; 

g.fillRect (ceglyX[i] [j], 
g.setColor (Color.white); 
g.drawRect (ceglyX[i] [jl], 


1 


ceglyY[i](j], szerCegla, wysCegla) a 


ceglyY[i]([j], szerCegla, wysCegla)z 


1 Następnie należy narysować ob- 
wódkę poprzez polecenie draw- 
Rect w formie: g.drawRect(ceglyX[i][j], 
ceglyY[i][j], szerCegla, wysCegla); 
1 Stworzoną w ten sposób metodę 
należy wywołać © w zbiorczej me- 
todzie rysującej. i 


private void rysnuj(Graphics g) ( 
rysujPaletke (g); 
rysujPilke (g) ; 
rysujcegly(g); 


1 Po uruchomieniu programu cegły 
(w wylosowanej liczbie kolumn 
i wierszy) są już widoczne 


Ś: Artanocks = x 


Ukrywanie zbitych cegieł 


M etoda rysujCegly podczas rysowania 
nie uwzględnia tego, czy rysowana 
cegła została już zbita, czy jeszcze nie. Nale- 
ży stworzyć mechanizm, który pozwala na 
oznaczanie, czy cegła została trafiona i czy 
powinna być narysowana. 


Informacja o tym, czy dana cegła została 
zbita, powinna znaleźć się w specjalnie 
do tego celu utworzonej tablicy dwuwymia- 
rowej, której elementy będą numerowane 
tak jak w przypadku dwóch poprzednich 


będą odnosiły się do tej samej cegły we 
wszystkich tablicach, z jakich skorzystamy 
w tym zastosowaniu. 

Nowa tablica przechowuje inny rodzaj da- 
nych. Wcześniejsze tablice przechowywa- 
ły liczby całkowite. A ta tablica powinna 
przechowywać zero-jedynkową informację 
o tym, czy dana cegła została już trafiona, czy 
nie. Nowa tablica powinna mieć więc typ 
danych boolean. Można ją stworzyć, pisząc 
linię kodu: private boolean czyZbite[][] = 
new boolean[kolumny][wiersze]; 


tablic do przecho- ( prIVate INL CEJIAYUSTEPGULA = IU; 

wywania współ- private int ceglyX[][] = new int[kolumny] [wiersze]; 

rzędnych cegieł. private int ceglyYl] [] = new int[kolumny)] [wiersze]; 

Te same numery private boolean czyZbite[][] = new boolean[kolumny] [wiersze]; 
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public PanelGry() 1 
initComponents (); 
setBackground(Color.black); 


for (int i — 0; i < kolumny; i++) 


czyZbite[i] [j] false; 


setPreferredSize (new Dimension (OKNO_SZER, OKNO_WYS)):; 


( 


« (szerCegla + ceglyOdstep) + ceglyOdstepLewa; 
(wysCeqla + ceqlyOdstep) + ceglaOdstepGora; 


tor (int j = 0; j <€ wiersze; j++) | 
ceglyX[i][j] = i 
ceglyY[i][j] = ji * 


Podobnie jak w przypadku poprzednich 

tablic wartości poszczególnych elemen- 
tów powinny zostać nadane w konstrukto- 
rze. W przypadku tej tablicy także należy się 
odnosić do każdej cegły z osobna. To ozna- 
cza konieczność wykorzystania dwóch pętli 
for. Wcale nie trzeba robić nowych pętli - 
można wykorzystać te stworzone wcześniej 
iw nich, oprócz obliczania współrzędnych, 
oznaczać cegły jako jeszcze nie zbite, bo taki 
powinien być ich stan początkowy. 
Typ danych boolean pozwala na przecho- 
wywanie dwóch wartości: true, co ozna- 
cza prawdę, i false, co oznacza nieprawdę 
(fałsz). 
Jeśli tablica nazywa się czyZbite, odpowie- 
dzią na to pytanie byłoby false, ponieważ 
w stanie początkowym wszystkie cegły nie 
są jeszcze zbite. 


Aby oznaczyć cegły jako jeszcze nie zbite, 
należy do wnętrza pętli dopisać: czyZbi- 
te[i][j] = false; 


By w oknie gry pojawiały się tylko te 

cegły, które nie są jeszcze zbite, trzeba 
zmodyfikować metodę rysujCegly. Wykony- 
wanie ciągu instrukcji odpowiedzialnych za 
rysowanie każdej z cegieł powinno być uza- 
leżnione od wartości znajdującej się w tabli- 
cy czyZbite dla elementu odpowiadającego 
cegle, wynikającej z iterujących pętli. 
Wykonywanie pewnych instrukcji od zaist- 
niałych warunków możliwe jest przy wyko- 
rzystaniu instrukcji warunkowej - if. Zatem 
cztery linie kodu odpowiedzialne za ryso- 
wanie należy zamknąć w nawias klamrowy, 
trzeba je też poprzedzić słowem if wraz z na- 
wiasem, w którym będzie zapisany warunek 
mówiący o tym, że cegła, do której odnosi 
się aktualnie sformułowanie czyZbite[i][j], 
faktycznie nie była zbita. Robimy to, pisząc: 
if (IczyZbitefi][j]) 


Dodanie tej instrukcji po uruchomie- 
niu programu nie wprowadzi widocz- 
nych zmian. Jak w takim razie sprawdzić, 


private void rysujCegly (Graphics g) ( 
for (int i = 
for (int j = 0; 


if (!czyzbite[i]j[j]) ( 


0; i < kolumny; i++) 


t 


j < wiersze; j++) | 


g.setColor (Color.red) ; 

g.fillRect (ceglyX[i][j], ceqlyr[i][j], szerCegla, wysCeqla) s 
g.setColor (Color.whitc) ; 

g.drawRect (ceglyX[i] [j], ceglyY[i][j], szerCegla, wysCegla) s 
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czy wszystko zostało napisane poprawnie? 
W konstruktorze, gdzie nadawana jest war- 
tość początkowa dla elementów tablicy czy- 
Zbite, można zmienić false na true ©. Wtedy 
po ponownym uruchomieniu gry cegły sta- 
ną się niewidoczne, co oznacza, że skrypt 
został napisany prawidłowo. Po wykonaniu 


Ruch piłki 


tor (int i = 0; i < kolumny; 
for (int j — 0; j < wiersze; j+ł) | 

ceglyX[i][j] = i * (szerCegla + cd 
ceglyY[i][j] = j * (wysCegla t ced 
c. ;e[i][j] — true; 


i++) ( 


tego testu należy przywrócić wartość false 
w tablicy. 


lementy gry zosta- 


private int ceglyx[][] 


= new int[kolumny] [wiersze]; 


ły już narysowane private int ceglyY[(][] = new int[kolumny] [wiersze]: 
private boolean czyzbite[] [] = new boolean[kolumny] [wiersze]; 


Kolejnym krokiem 


private int dx = 2; 


jej realizacji powinno 
być wprowadzenie interakcji pomiędzy 
tymi elementami. W interakcje z cegła- 
mi i paletką wchodzi piłka. Bez jej ruchu 
w grze nic by się nie działo. 


Zastanówmy się: w gruncie rzeczy 
„ruch” piłki jest zmianą jej położenia. 
A położenie może zmieniać się na osi X 
(w poziomie) i na osi Y (w pionie). 
Ruch piłki musi być stały. Nie zatrzymuje się 
ona, a jedynie zmienia kierunek lotu, odbi- 
jając się od ścian, paletki i cegieł. 
Dlatego do skryptu należy wprowadzić dwa 
nowe pola - dx i dy, które będą odpowiadały 
za „krok”, jaki wykonuje piłka, odpowiednio 
na osi X i osi Y. 
Inaczej mówiąc, z każdym kolejnym wy- 
wołaniem metody odpowiedzialnej za ruch 
piłki wartości tych pól zostaną dodane od- 
powiednio do współrzędnej X i współrzęd- 
nej Y piłki. 
Gdy dx będzie miało wartość dodatnią, to 
na osi X piłka będzie się poruszać w prawą 
stronę, bo jej odległość od lewej krawędzi 
będzie rosnąć. 
By piłka poruszała się w stronę lewą na 
osi X, trzeba nadać polu dx wartość ujemną. 
Natomiast w przypadku osi Y - gdy dy 
będzie miało wartość dodatnią, to piłka 
będzie poruszała się w dół, a gdy ujemną 
- w górę. 
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Pola dx i dy powinny być zadeklarowane 

jako liczby całkowite, a ich początkowe 
wartości powinny być takie, by na starcie 
gry piłka leciała w górę, a nie w dół. Moż- 
na zapisać zatem private int dx = 2; 6, 
by piłka leciała w prawą stronę, i private 
int dy = -2; ©, by równocześnie przemiesz- 


private int dx = 2; 


private int dy = -2; 


todę ruchPilki ©, a w jej treści dodawać 
wartości pól dx i dy do współrzędnych piłki. 


private void ruchPilki() ( 


, 


f T 


W treści metody ruchPilki należy wyko- 

nywać dodawanie wartości pól dx i dy 
odpowiednio do xPilki i yPilki. Zapisujemy 
to w taki sposób, by dla xPilki nowa wartość 
wynosiła dotychczasową wartość plus dx: 
xPilki = xPilki + dx; ©- 


private void ruchPilki() 4 
xPilki = xPilki + dx; 


ł 


adam1l3zajacigmail.com 


600; 
500; 
int szerPaletki = 100; 

10; 


private 
private 


final int OKNO_SZER = 
final int OKNO_wyS = 
privaLe 


private int wysPaletki = 


nrirata 


public class PanelGry extends javax.swing.JPanel implements ActionListener 


jntown = [OEN) C7PP — corarDalatkit / 9 


Ze współrzędną y postępujemy analo- 
gicznie: yPilki = yPilki + dy; 


private void ruchPilki() ( 
xPilki = xPilki + dx; 
yPilki = yPilki ł dy; 


U 


Teraz zastanówmy się, kiedy należy wy- 

woływać nową metodę. Powinno to 
mieć miejsce cyklicznie z pewnym odstępem 
czasu. By było to możliwe, nasza klasa będzie 
potrzebowała skorzystania z Timera. Obiekt 
tej klasy jest w stanie cyklicznie wywoływać 
działanie. Należy więc zadeklarować obiekt 
timer klasy Timer poleceniem: private Timer 
timer; 


private pooiean CZyGDp1i 
private int dx = 2; 
private int dy = -2; 


private Timer Limer; 


By klasa Timer była rozpoznawana przez 
ten projekt, należy dokonać importu bi- 
blioteki: import javax.swing.Timer; 


java.awt.Color; 


java. 


-| import 


import awt.Dimension; 


import java.awr.Graphics; 


import java.util.Random; 


import javax.swing.Timer; 


Oprócz deklaracji obiektu trzeba jesz- 
cze wywołać jego konstruktor, aby wy- 
tworzyć obiekt. Możemy to napisać w kon- 
struktorze klasy PanelGry. Tam należałoby 
użyć linii: timer = new Timer(10, this); ©; 
gdzie liczba 10 odnosi się do interwału ko- 


czyZbite[i][j] = false 


10, this); 


lejnych wywołań (czas wyrażony w milise- 
kundach), a słowo this - do bieżącej klasy. 


Program podkreśla słowo this jako błąd. 
By zostało ono rozpoznane przez pro- 
gram w tym kontekście, do definicji klasy 
należy dodać implementację interfejsu Ac- 
tionListener. Należy zatem nieco zmienić li- 
nię tworzącą klasę, by miała ona postać: pu- 
blic class PanelGry extends javax.swing. 
JPanel implements ActionListener f 
1 By interfejs ten był rozpoznany przez 
program, niezbędne jest dodanie im- 
portu - import java.awt.event.ActionLi- 
stener; 


mporr 
import 


JAVA-AWT-G wh 
java.util.Random; 
import javax.swing.Timer; 


import java.awtL.event.AcLionListener; 


1 1. program również zgłasza błąd - 

klasa, implementując interfejs, musi 
mieć w sobie wszystkie metody zawarte w da- 
nym interfejsie. To wymusza implementację 
metody actionPerformed. W jej wygenero- 
waniu może pomóc NetBeans. Klikamy na 
ikonę błędu obok definicji klasy. Z rozwinię- 
tej listy możliwych rozwiązań trzeba wybrać 
opcję Implement all abstract methods. ©, 
co wygeneruje w klasie PanelGry wszystkie 


zo] T 

w 

zdy 

23 Dp_SZER = 600; 
24 private final int OKNO_wYs = 500; 


R private int szerPaletki = 100; 
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GOverride 


ł 


public void acotionPerformed(ActionEvent ©) ( 
throw new UnsupportedoperationException("Not supported yet."); 


metody wymagane implementowanym inter- 
fejsem. W przypadku tego interfejsu jest to 


jedna metoda - actionPerformed 
1 W parametrze tej metody mamy 
obiekt klasy ActionEvent, która nie 


1 Uruchomienie programu na tym eta- 

pie jeszcze nie da efektu poruszają- 
cej się piłki. To dlatego, że program jedynie 
zmienia logiczne wartości lokalizacji piłki, 
a piłka nadal jest narysowana w swojej lo- 
kalizacji początkowej. Konieczne zatem jest 


jest rozpoznawana przez ten projekt. By 
została rozpoznana, należy dokonać impor- 


import javax.swing.Timer; 


import java.awL.eventL.AcLionListener; ) 


Goverride 
public void acŁionPerformed(ActLionEvent e) 


ruchPilki (); 
repaint (); 


1 


import java.awt.event.ActrionFvent; 
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tu odpowiedniej biblioteki - import java. 


awt.event.ActionEvent; 

1 To, co znajduje się w definicji metody 
actionPerformed, będzie przez timer 

wykonywane z określonym wcześniej inter- 

wałem. Należy zmienić treść wygenerowanej 

metody, usuwając z jej treści znajdującą się 


ponowne narysowanie elementów okna. 
Można to osiągnąć za pomocą polecenia 
repaint ©, które (w skrócie) prowadzi do 
wywołania metody paintComponent, czyli 
tej, w której wywołujemy rysowanie ele- 


mentów gry. 

1 Na razie jednak piłka jeszcze się nie 
poruszy, a to dlatego, że timer nie zo- 

stał uruchomiony. Zeby go uruchomić, trze- 


tam linię kodu 2 


GOverride 


public void actionPerformed (ActionEvent e) ( 


ba użyć polecenia timer.start(); ©- 
Może ono zostać wpisane w konstruk- 
tor. Po tej operacji, po uruchomieniu 
programu, piłka zacznie przemiesz- 


) 
1 W treści metody actionPerformed 
powinna być wywoływana metoda 
ruchPilki 


timer = new Timer(10, this); 


timer.start(); 


Qoverride 


ruchPilki(); 


public void actionPerformed(ActionEvent e) (| 


czać się w kierunku wynikającym 
z wartości pól dx i dy. 


Odbijanie piłki 


M etoda ruchPilki działa teraz tak, że cały 
czas przesuwa piłkę w kierunku określo- 
nym przez pole dx i dy, natomiast nie bierze 
pod uwagę jej lokalizacji - kierunek nie zmie- 
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nia się, gdy piłka dotrze do krawędzi okna. 
Po prostu wylatuje ona z okna gry. Należy tak 
zmodyfikować definicję metody, by w takim 
wypadku kierunek ruchu się zmieniał. 
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Przed zmianą kierunku 


piłki należy sprawdzić, it (xPilki<=0 || xPilki > OKNO SZER - srednicaPilki) ( 
czy dotyka ona krawędzi dx = dx*-1; 
okna. Takiego sprawdzenia U 
if (yPilki <= 0)4 


można dokonać poprzez 
instrukcję warunkową. Dla 
lewej krawędzi okna, gdy 
xPilki (czyli odległość piłki 
od lewej krawędzi) będzie | , 


, 


yPilki 


private void ruchPilki() ( 


xPilki — xPilki + dx; 
= yPilki + dy; 


mniejsze lub równe zeru 
x powinno zostać pomnożone przez -1 ©, co 
jest równoznaczne ze zmianą kierunku piłki. 


private void ruchPilki() £ 
if (xPilki<=0) ( 
dx = dx*-1; 


+ 
xPilki = xPilki + dx; 
yPilki = yPilki + dy; 


) 


Instrukcję warunkową możemy zmo- 

dyfikować tak, by dodać do niej drugi 
warunek. Jeśli warunki będą połączone 
spójnikiem „lub”, do wykonania zmiany 
kierunku wystarczy, że jeden z warunków 
zostanie spełniony. Drugi warunek powi- 
nien dotyczyć dotarcia przez piłkę do pra- 
wej krawędzi. Wydawać by się mogło, że 
piłka dotyka prawej krawędzi okna, gdy 
jej odległość od lewej krawędzi jest równa 
szerokości okna. Jednak wtedy piłka jest już 
poza oknem. Piłka swoją prawą krawędzią 
dotyka prawej krawędzi okna, gdy odległość 
piłki od lewej krawędzi zrówna się z szero- 
kością okna pomniejszoną o szerokość piłki 


Podobne odbijanie należy opisać także 

dla osi Y - piłka ma odbijać się też od 
górnej krawędzi okna i od paletki. Poprzez 
instrukcję warunkową trzeba sprawdzić, 
czy odległość piłki od górnej krawędzi jest 
równa zeru (bądź mniejsza od zera) . Wtedy 
piłka powinna zmienić swój kierunek ruchu 
na osi Y. Piszemy zatem if (yPilki <= O)f ) ©, 
by utworzyć warunek, 


. if ilki <= 0 

i dy = dy*-1; , by i (yPilki <= 0)1 
Rade ufa dy = dy*-1; 

zmienić kierunek rtu- ) 


chu piłki. 


Podobnie jak poprzednio do odbijania 

piłki na osi Y też możemy użyć jednej 
instrukcji warunkowej - z połączonymi 
spójnikiem warunkami. Jednak w przypad- 
ku dolnej krawędzi okna warunki muszą być 
nieco inne: 

m Piłka musi mieścić się w zasięgu paletki na 
osi X. Zatem jej odległość od lewej krawę- 
dzi okna musi być większa niż odległość 
paletki od lewej krawędzi okna. Jedno- 
cześnie odległość piłki od lewej krawędzi 
okna nie może być większa niż odległość 


private void ruchPilki() ( 


dx = dx*-1; 


, 
xPilki = 
yPilki = 


xPilki + dx; 
yPilki + dy; 


ł 


if (xPilki<=0 || xPilki > OKNO SZER — srednicaPilki) ( 


prawej krawędzi pa- 
letki od lewej krawę- 
dzi okna - wszystko 
to możemy zapisać 
jako dwa warunki: 
xPilki > xp i xPilki 
< xp + szerPaletki - 


(czyli jej średnicę). Warunek powinien mieć 
zatem postać: xPilki > OKNO_SZER - sred- 
nicaPilki ©. Do połączenia warunków spój- 
nikiem „lub”, używamy dwóch pionowych 
kresek - || ©. 


co istotne, muszą być 
one spełnione jednocześnie - takie warun- 
ki łączy się spójnikiem „i”, czyli 86. 

z Na osi Y piłka musi swoją dolną krawę- 
dzią dotykać górnej krawędzi paletki, 
czyli odległość piłki od górnej krawędzi 
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if (yPilki <= 0 
dy = dy*-1; 


) 


Il ypilki t srednicapilki >= yp 66 xPilki > xp 66 xPilki < xp t szerPaletki)i 


musi być co najmniej taka, jak odległość 
paletki od górnej krawędzi okna, pomniej- 
szona o średnicę piłki. Można to zapisać 
jako yPilki + srednicaPilki >= yp. Ten 
warunek musi być spełniony wtedy, kiedy 
są spełniane dwa warunki opisane w po- 


Ruch paletki 


y sprawdzić, czy piłka odbija się od palet- 

ki, konieczne będzie wprawienie paletki 
w ruch. W tym celu należy wprowadzić do 
programu mechanizm obsługi klawiatury - 
to za jej pomocą, a konkretnie klawiszami 
strzałek, będzie sterowana paletka. 


Do klasy PanelGry musimy dopisać klasę 
wewnętrzną. Klasy wewnętrzne są uży- 
teczne tylko w kontekście klasy, w której się 
znajdują. Gdyby klasa miała być użyteczna 
poza nią, powinna być poza nią zdefiniowa- 


przednim punkcie - więc trzeba go z nimi 
połączyć spójnikiem „i”. 
Cały warunek w tej instrukcji powinien mieć 
postać: yPilki <= 0 || yPilki + srednicaPil- 
ki >= yp 8.6 xPilki > xp 8.8 xPilki < xp + 
szerPaletki ©. 


Nowa klasa po KeyAdapter dziedziczy 

metodę keyPressed - jednak należy me- 
todę tę nadpisać, by program w zależności 
od tego, który klawisz zostanie naciśnięty, 
zachowywał się tak, jak chce tego progra- 
mista. Dlatego użyjemy zapisu ©Override 
przed definicją metody keyPressed, która 
powinna mieć postać public void keyPres- 
sed(KeyEvent e) [ ) ©, gdzie pod KeyEvent e 
kryje się obiekt, w którym przechowywana 
będzie informacja o tym, który klawisz był 
ostatnio naciśnięty. 


na. Ale nowa klasa ma służyć jedynie do 
zmieniania współrzędnych paletki, które 
są dostępne wyłącznie w klasie PanelGry. 
Klasę wewnętrzną definiujemy w taki 
sposób, jak każdą inną klasę, tylko we- 
wnątrz klasy zewnętrznej jak metody 
klasy. Trzeba stworzyć klasę dziedziczą- |» 


private class Sterowanie exLends KeyAdapter 


GOverride 
public void keyPressed(KeyEvent e) ( 


LU 


cą po klasie KeyAdapter - pozwala ona 

(a konkretnie jej metoda keyPressed) między 
innymi na odczyt, jaki klawisz został ostat- 
nio naciśnięty. By dodać wewnętrzną klasę 
dziedziczącą po klasie KeyAdapter o nazwie 
Sterowanie, należy napisać private class 


By klasa KeyEvent była rozpoznawana 

przez program, trzeba dokonać importu 
biblioteki - import java.awt.event.Key- 
Event; 


IUPUTEU JAVA:AWL-JIAPIIIC57 
import java.util.Random; 


Sterowanie extends KeyAdapter( ) r 


private class Sterowanie extends KeyAdapter 


, 


import javax.swing.Timer; 


import java.awt.event.ActionListener; 


import java.awt.event.ActionEvent; 


import java.awt.event.KeyAdapter; 


By klasa bazowa KeyAdapter była rozpo- 

znawana przez program, trzeba dokonać 
odpowiedniego importu - import java.awt. 
event.KeyAdapter. 
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GOverride 
public void keyPressed(KeyEveuLl e) ( 
int key = e.getkKeyCode () ; 


gry, a znajduje się w nim wtedy, kiedy jej 
współrzędna x jest większa od zera. Cała 
instrukcja warunkowa powinna mieć po- 
stać: if (key == KeyEvent.VK_LEFT 8.8 
xp > 0)£ ] 


e.getKeyCode() ©. Ukrywa się tam liczba 
całkowita odpowiadająca swoim kodem 
jednemu z klawiszy klawiatury. Tę liczbę 
możemy zachować w zmiennej. W tym 
celu można utworzyć zmienną o nazwie 
key i jako wartość dać jej to, co zwraca 
polecenie, w którym przechowywana jest 


GOverride 
public void 


keyPressed(KeyEvent e) ( 
int key = e.getKeyCode (); 
if (kay == KeyFvent.VK_ LEFT 6« xp > 0) 


) 


— 


liczba odpowiadająca klawiszom. Powin- 
no to mieć formę: int key = e.getKeyCode(); 


Czy aby sprawdzić jakiś klawisz, trzeba 
znać jego kod wyrażony liczbą? Nieko- 
niecznie - należy jednak znać jego nazwę 


Następnie należy określić, jaka instruk- 

cja ma się wykonać, gdy warunki będą 
spełnione, a ma to być zmniejszenie wartości 
pola xp, co można zapisać następująco: xp = 
xp - 10; 


w klasie KeyEvent (i to też nie jest do 
końca konieczne, gdyż podczas pisania 
IDE może nam sugerować dostępne 
polecenia, wśród których są także na- 
zwy klawiszy). Numer odpowiadający 
strzałce w lewą stronę kryje się pod 
KeyEvent.VK_LEFT. Poprzez instruk- 


U 


GOverride 
public void keyPressed(KeyEvent e) ( 


int key = e.getKeyCode (); 


if (key == KeyEvent.VK LEFT 66 xp > 0) ( 


cję warunkową należy sprawdzić, czy 
zmienna key jest równa KeyEvent.VK_LEFT 
i wtedy zmienić współrzędną x paletki tak, 
by przesunęła się w lewą stronę. Warunek 
ten można połączyć z jeszcze jednym, któ- 
ry powinien być równocześnie spełniony. 
Drugi z warunków dotyczy sprawdzenia ak- 
tualnej odległości paletki od lewej krawędzi 
okna. Chodzi o to, żeby nie dało się przesu- 
nąć paletki poza okno gry. Aby można było 
przesunąć paletkę, musi ona być w oknie 


Podobnie powinno wyglądać przesu- 

wanie paletki w prawą stronę. Trzeba 
zbudować instrukcję warunkową, w której 
muszą być spełnione dwa warunki - jeden 
mówiący o wciśnięciu klawisza strzałki 
w prawą stronę, a drugi o tym, że paletka 
swoją prawą krawędzią mieści się jeszcze 
w oknie gry. Cała instrukcja powinna mieć 
zatem formę: if (key == KeyEvent.VK_ 
RIGHT 8.8: xp < OKNO_SZER - szerPaletki) 


(GOverride 
publice void keyPressed(KeyFvent =) ( 
int key — e.gelLReyCode () ; 


if (key == KeyEvent.VK LEFT ££ xp > 0) 


xp = xp 10; 


, 
if (key == KeyEvent.VK RIGHT «s xp < 


ł 


OKNO SZER -— szerPaletki) ( 


tl 


Gdy warunki 
z instrukcji będą 
spełnione, pole xp 
powinno zwiększyć 
swoją wartość o tyle, 
o ile zmniejszało się 
w przypadku spełnie- 
nia warunków z po- 


przedniej instrukcji 
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private class Sterowanie extends KeyAdapter ( 


GOverride 
public void keyPressed(KeyEvent e) ( 
int key = e.getkKeycCode () ; 


if (key —— KceyEvent.VK LEFT «s xp > 0) [| 
xp = xp -— 10; 

, 

if (kcy —— KceyEvent.VK RIGHT «s xp < OKNO_SZER -— szerPaletki) ( 
xp = xp + 1U; 


warunkowej. Należy zatem napisać: Xp = xp 
+ 10; ©. W ten sposób zakończyliśmy defini- 
cję metody keyPressed - możemy zająć się 


jest aktywny. Można powiedzieć, że wspo- 
mniane polecenie „aktywuje” komponent 
(czyli w tym wypadku PanelGry). 


1 Teraz zarówno piłka, jak i paletka są 
już w ruchu ©. Do zakończenia gry 
pozostaje jeszcze dodanie wykrywania kolizji 
pomiędzy piłką a cegłami i zakończenie gry, 
gdy gracz nie zdoła odbić piłki paletką. 


PYPA 


jej wywoływaniem. 

1 Wspomniana metoda będzie automa- 
tycznie wywoływana, gdy zostanie 

naciśnięty jakiś klawisz, jednak najpierw trze- 

ba dodać obiekt klasy Sterowanie do klasy 

PanelGry. W tym celu w konstruktorze klasy 

PanelGry należy napisać addKeyListener- 


(new Sterowanie()); 

1 Niezbędne jest też wywołanie polece- 
nia setFocusable(true); ©. Zdarze- 

nia wysyłane są tylko do komponentu, który 


timer = new Timer(10, this); 
timer.start(); 
addkeyListener (new Sterowanie ()); 


setFocusable (true) ; 


public PanelGry() ( 
initComponents (); 
setBackground(Color.black); 
serPreferredSi ze (naw Dimension (OKNO_SZFR, OKNO_WYS) ) ; 


for (int i = 0; i X kolumny; itt) ( 
for (int j = 0; j < wiersze; j++) | 
ceglyX[i][j] 7 i * (szerCegla + ceglyOdstep) + ceglyOdstepLewa; 
ceglyYr[i][j] = j * (wysCegla + ceglyOdstep) + ceglaOdstepGora; 
czyzbite[i][j] = false; 


timer = new Timer(10, this); 
timer.start(); 
addkeyListener (new Sterowanie ()); 
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Zderzenie piłki z cegłą 


B o wykrywania, czy piłka uderzyła w ce- 
głę, należy zbudować oddzielną meto- 
dę. Powinna ona mieć następującą postać ©, 
gdzie: 

EJ - jest deklaracją metody o nazwie 
zderzenieZCegla; 

[HB - jest pętlą for, która przechodzi po kolej- 
nych kolumnach cegieł; 

[H- jest pętlą for, która przechodzi po kolej- 
nych wierszach w kolumnie cegieł; 

[J- jest instrukcją warunkową sprawdzającą, 
czy cegła, do której odnosi się numer wy- 
znaczony przez iteracje obu pętli, nie została 


E] - zmiana kierunku ruchu piłki na osi Y; 
zapis ten tożsamy jest z zapisem dy = dy*-1; 
[M- oznaczenie cegły, z którą koliduje piłka, 
jako zbitej; 

MI - else if pozwala na dodanie do instruk- 
cji warunkowej kolejnego warunku, który 
będzie sprawdzony tylko w wypadku, gdy 
poprzednie warunki nie zostały spełnione; 
EJ- zestaw warunków, które muszą być speł- 
nione, by program uznał, że piłka uderzyła 
w cegłę, lecąc do niej z boku; 

[M - zmiana kierunku ruchu piłki na osi X; 
zapis ten jest tożsamy z zapisem dx = dx*-1; 


jeszcze zbita; 

B_- jeśli warunek o oznaczeniu 
cegły jako jeszcze nie zbitej jest 
spełniony, kolejnym krokiem jest 
stworzenie instrukcji warunkowej 
do sprawdzania, czy piłka koliduje 


QGOverride 

public void actionPerformed(ActionEvent e) ( 
zderzenieZCegla (); 
ruchPilki (); 


repaint (); 


teraz z cegłą, do której odnoszą się 
zmienne i ij; 

[A- zestaw warunków, które muszą być jed- 
nocześnie spełnione, by program uznał, że 
piłka uderzyła w cegłę, lecąc do niej od dołu 
bądź od góry; 


Metodę zderzenieZCegla © należy wywo- 
łać w metodzie wywoływanej przez timer. 
Sprawi to, że z każdym ruchem piłki będzie 
wykonywane też sprawdzenie, czy uderzyła 
ona w cegłę. 


[private void zderzenicZcegla() | 


EJ ©or (int i =0; i < kolumny; 


© w = -dy; 


[MB ax - 


-dx; 


U 


1++) 4 
[J cor (int j = 0; j < wiersze; j++) | 
Mic (czyzbitefi1(j] — f[alse) £ 
[AH i£ (EFIIki > ceglyx[i] (J] 
xPilki 
yPilki + srednicaPilki > ceglyY[i][j] 
yPilki < ceglyY[(i][j] + wyscegla) 


KD czyzbitef[i] (3] = 


s£ ypilki 
jice xPilki 
sa xPilki 


DM czyzbitelij ij] = 


< ceglyX[i][j] + szerCegla 


true; 
ceglyY[i] [j] 
ceglyY[i][j] + wyscegla 


+ A V 


srednicaPilki > ceglyX[i][j] 
ceglyX[i][j] + szerCeqla) 


A 


true; 
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Zakończenie gry 


y4 akończenie gry może mieć dwa 
warianty - wygraną i przegra- 
ną. Pierwsza z opcji występuje, gdy 
zostaną zbite wszystkie cegły, druga 
zaś, gdy piłka wypadnie z okna gry 
poprzez dolną krawędź. Zakończe- 
nie gry powinno skutkować wy- 
świetleniem odpowiedniego napisu 
i ukryciem tego, co dotychczas było 
widoczne. Będzie to wymagało edycji 
metody odpowiedzialnej za rysowa- 
nie na panelu. 


Należy wprowadzić specjalne 
pole w klasie PanelGry, którego 
wartość będzie mówiła o tym, jaki jest 
stan gry. Deklarujemy pole stanGry | ) 


private void sprawdzStan () 
[J £ (yPilki > OKNO WYS) 


|C| int niezbite = 0; 
[] for (int i = 0; i < 


[J i£ (niezbite == o) 


[Jstancry = "PRZEGRYWASZ"; 


kolumny; i++) ( 
| E ECH (int j = 
[JĄ if (czyzbite[i][j] == false) ( 
[] niezbite += 1: 
> 


0; j < wiersze; jtt) ( 


) 


[M] stancry = "wycRywasz"; 


jako typ danych String. Będzie ono 
mogło przyjmować wartości tekstowe - na 
przykład: „trwa”, „wygrana”, „przegrana”. Na- 
leży napisać zatem private String stanGry 
= "trwa; ©. 
[| private DUULEGII CZ YSFILET NTI = 
private int dx = 2; 
-2; 


Timer timer; 


private int dy = 
private 


private String stanGry = "trwa"; 


By modyfikować wartość nowego pola 
klasy, można zbudować nową metodę, 
która będzie sprawdzała położenie piłki i licz- 
bę cegieł do zbicia. Nowa metoda sprawdz- 
Stan może mieć postać $, gdzie: 
[JV- jest instrukcją warunkową sprawdzającą, 
czy piłka opuściła już okno gry przez jego 
dolną krawędź; 
[H- jeśli warunek o opuszczeniu okna przez 


EH- jest pętlą for, która przechodzi po kolej- 
nych wierszach w kolumnie cegieł; 

[i - jest instrukcją warunkową, sprawdza- 
jącą, czy cegła, do której odnosi się numer 
wyznaczony przez iteracje obu pętli, nie zo- 
stała jeszcze zbita; 

[J - jeżeli cegła nie została zbita, zwiększa 
wartość zmiennej zliczającej cegły, które nie 
zostały jeszcze zbite; 

[I - instrukcja warunkowa sprawdzająca, 
czy policzono jakiekolwiek cegły, które nie 
zostały zbite; 

[I - jeśli brak cegieł do zbicia - ustawia war- 
tość pola stanGry na WYGRYWASZ. 


Metoda do sprawdzania stanu roz- 

grywki powinna być wywoływana 
wraz ze zdarzeniem timera w metodzie 
actionPerformed. 


piłkę został spełniony, ustawia wartość 
pola stanGry na PRZEGRYWASZ - na- 
pis ten zostanie dalej wykorzystany do 
wyświetlenia go na ekranie; 

[H- tworzy nową zmienną do zliczenia 
cegieł, które pozostały na ekranie; 
[]- jest pętlą for, która przechodzi po 
kolejnych kolumnach cegieł; 


Goverride 
public void action-ferformed(Actionkvent e) 4 


sprawdzStan () ; 
zderzeniezCegla (); 
ruchPilki(); 
repaint (); 
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private void koniec(Graphics g) 


Powinna zostać zdefiniowana metoda 

koniec 6, która będzie umieszczała na 
środku ekranu napis WYGRYWASZ lub PRZE- 
GRYWASZ (w zależności od tego, jaką war- 
tość ma stanGry). 


gości napisu tworzonego przez wcześniej za- 
deklarowaną czcionkę. Dzięki temu będzie 
możliwe obliczenie dokładnej lokalizacji 
napisu, tak by odległości od prawej i lewej 
krawędzi okna były takie same. 


import java.awt.Font; 


import java.awt.FontMetrics; 


private void konico(Craphics g) ( 


Font czcionka = new Font("Helvetica", 


Font. BOLL, 


By klasa FontMetrics 
była rozpoznana przez 


Mój program, należy dodać 


W metodzie koniec poprzez linię Font 
czcionka = new Font(„Helvetica”, 
Font.BOLD, 14); © należy utworzyć obiekt 
klasy Font, który posłuży jako czcionka do 
wygenerowania napisu. Liczba 14 jest tu 


import biblioteki: import 
java.awt.FontMetrics; 


Poleceniem g.setColor(Color.white); 
należy ustawić kolor tworzonego napisu 
(w naszym przykładzie jest to kolor biały). 


rozmiarem czcionki, 
można oczywiście użyć 
innego rozmiaru, a tak- 
że czcionki innej niż 
Helvetica. , 


Font czcionka 


private void koniec(Graphics g)( 


FontMetrics metr = 


g.setColor (Color.white) ; 


= new Font("Helvetica", Font. BOLD, 
getFontMetrics (czcionka) ; 


14); 


ZIPUIU—_UWUTUWYT WEUTEJITW 
java.awt. 


java.awt. 


event.ActionEvent; 
event.KeyAdapter; 
event .KeyEvent; 
Font; 


import 
import 
import java.awt. 
import 


java.awt. 


1 Następnie poleceniem g.setFont(cz- 

cionka); © przypisujemy wcześniej 
utworzony obiekt klasy Font jako czcionkę 
do tworzenia napisów. 


By klasa Font była roz- 
poznana przez program, 
należy dodać import biblio- 
teki - import java.awt. 
Font; 


H 


private void koniec(Graphics g) 
Font czcionka = new Font("Helvetica", 
FontMetrics metr = 
g.setColor (Color.white); 
g.setFont (czcionka) ; 


Font . BOLD, 
getFontMetrics (czcionka) ; 


14); 


Dalej w metodzie ko- 
niec należy poprzez linię FontMetrics 
metr = getFontMetrics(czcionka); © utwo- 
rzyć obiekt, który pozwoli na obliczenie dłu- 


1 1 Poleceniem g.drawString(stanGry, 
(OKNO_SZER - metr.stringWid- 
th(stanGry)) / 2, OKNO_WYS/ 2); 


należy 


FontMetrics metr = 
g.sotColor(Color.whito); 
q.setFont (czcionka); 
g.drawString(stanGry, 


private void koniec(Graphics g)f utworzyć na Środ u okna 
Font czcionka = new Font("Helvetica", Font.BOLD, 14); gry napis, którego tekst 
FontMetrics metr = getFontMetrics (czcionka); będzie dokładnie taki jak 
) wartość pola stanGry. 
24) - private void konico(Graphics g) l 
L25 Font czcionka = new Font("Helvelica", Font.BOLD, 14); 


getFontMetrics (czcionka) ; 


(OKNO SZFR - metr.stringWidth(stanGry)) / 2, 


OKNO WYS / 2); 
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private void rysuj(Graphics g) 4 
if (stanGry == "Lrwa")(f 
rysujPaletke (g) ; 

rysujPilke(g); 
rysujCegly (g); 
) 


) 
1 2 Metoda rysuj powinna zostać zmody- 
fikowana w taki sposób, by obecne 
w niej do tej pory wywołania metod rysują- 
cych wykonywały się tylko wtedy, gdy pole 
stanGry ma wartość trwa ©. W przeciwnym 


wypadku po- 
winna być wy- 
oóiseidiz konywana me- 


: G toda koniec ę. 


rysujcegly (9); 


) else | 
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Programy użytkowe: 


rogramowanie to oczywiście nie tylko 

tworzenie gier. To także tworzenie róż- 
nego rodzaju oprogramowania użytkowego. 
W tym także dobrze sprawdzi się Java. Jako 
przykład oprogramowania użytkowego mogą 
posłużyć różnego rodzaju przeliczniki, które 
pobierają od użytkownika dane wejściowe, 
dokonują obliczeń, a potem prezentują wy- 
niki. Przykładem takiego programu może 
być narzędzie do obliczania BMI (Body Mass 
Index) - współczynnika masy ciała. Użyt- 
kownik podaje wzrost i wagę, a program, 
korzystając ze wzoru, zwraca mu wartość 
współczynnika. 


© |Palet... x = 
fh || 7 Świna Containers 
[| Panel labbed Pane || SplitPane 
k | Saroll Pane LZ. Tool Bar j-) Desktop Pane 
m [| Internal Frame |% | Layered Pane 
=| Swina Controls 
ubei Label |C| Lej Button |B | uj Toggle Button 
E- Check Box )- Radio Button 3 Button Group 
[EJ combo Box Ef List Text Field |A| 
("| Text Area CH Scroll Bar UD slider 
CE Progress Bar [--'] Formatted Field (=) Password Field 
12! Cninnar . 1 Cansrztnr T| TavetN"na x 
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PRZEGRYWASZ 


Przetestujmy teraz grę - zależnie od wyniku, 
jaki uzyskamy, po rozgrywce w oknie gry 
powinien pojawić się odpowiedni napis 


oblicz swoje BMI 


Program do obliczania BMI 
Tworzymy projekt zgodnie z instrukcją 
z rozdziału drugiego, dodając do niego 
okno, czyli JFrame Form. Na tej formatce 
można zbudować wygląd aplikacji - w pro- 
gramach użytkowych ważną rolę pełnią przy- 
ciski i pola tekstowe. 


Elementy okna programu przeciągamy 

na formatkę z panelu po prawej stronie. 
Program do obliczania BMI powinien skła- 
dać się z: dwóch pól tekstowych (Text Field 
ED do wpisania wzrostu i wagi; przycisku 
(Button EJ) do uruchomienia obliczania; 
trzech etykiet (Label [H) - jednej do pre- 
zentacji wyniku, a dwóch do podpisania pól 
tekstowych. 


Przeciągnięte elementy układamy w spo- 


sób podobny do zaprezentowanego ©. 


| jlabei? 


jTextFiekdi 


jlabel3 1Texrield2 


JButton1 jLabell 
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ł 


private void btnObliczAotionPerformed (java.awt.cvent.ActionEvent cvt) | 


By nadać elementom odpowiadającą nam 

formę, można zmienić ich rozmiary (za- 
znaczając element, można regulować jego 
wymiary, rozciągając go). Ważne dla osta- 
tecznego wyglądu programu są też napisy na 
jego poszczególnych elementach. Możemy je 
zmieniać poprzez zmianę wartości właści- 
wości text w zakładce Properties na pane- 
lu pod możliwymi do wyboru elementami 
okna. Właściwości wyświetlają się zawsze 
dla aktualnie zaznaczonego elementu okna. 


Pola tekstowe powinny mieć pusty text, 

przycisk powinien mieć słowo "Oblicz", 
a etykiety, zależnie od ich lokalizacji: "Wzrost 
[m]:”, *Waga [kg]:”, *"BMI:” 


Waga [kg]: 
Wzrost [m]: 


Oblicz BMI: 


By ułatwić odnoszenie się do poszczegól- 

nych elementów okna programu z pozio- 
mu skryptu, można zmieniać ich standardowe 
nazwy. By to zrobić, klikamy prawym przy- 
ciskiem myszy na element, którego nazwę 
chcemy zmienić, i wybieramy opcję Change 
Variable Name 6, by wyświetlić pole do poda- 


T 


waga (kol: | a 


Edit Text 


Events > 


wzrost [m]: 


nia nowej nazwy. W naszym przykładzie pola 
tekstowe powinny nazywać się tbxWzrost 
itbxWaga, przycisk btnOblicz, a etykieta do 
wyświetlania współczynnika - IblBmi. Przyjęło 
się, że w programowaniu nazwy składają się ze 
skrótu wskazującego na rodzaj elementu i czę- 
ści wskazującej na jego zastosowanie. (Ponie- 


ziomu skryptu, zmiana ich nazw nie jest ko- 
nieczna, jednak warto wiedzieć, jak to robi). 


Klikamy dwukrotnie na przycisk z napi- 
sem Oblicz na formatce. Spowoduje to 
wygenerowanie metody © i przeniesienie nas 
do skryptu. Ta nowa metoda będzie się wyko- 
nywać automatycznie w uruchomionym pro- 
gramie, gdy użytkownik kliknie na przycisk. 


W nowej metodzie umieszczamy następu- 

jące polecenia ©, które kolejno oznaczają: 
[JI - tworzy zmienną typu float o nazwie 
waga, do której jako wartość trafia przerobio- 
ny na liczbę tekst wpisany do pola tekstowego 
tbxWaga. 
EJ - tworzy zmienną typu float o nazwie 
wzrost, do której jako wartość trafia przero- 
biony na liczbę tekst wpisany do pola teksto- 
wego tbxWzrost. 
[FH - tworzy zmienną o nazwie bmi - typu 
float, do której zgodnie ze wzorem na współ- 
czynnik BMI trafia wartość zmiennej waga 
podzielona przez podniesioną do kwadratu 
wartość zmiennej wzrost. 
[7] - tworzy zmienną typu String o nazwie 
napis, w której przechowywany jest prze- 
robiony z liczby na tekst współczynnik BMI. 
EE - współczynnik BMI przerobiony do for- 
my tekstowej jest umieszczony na etykiecie 
IblBmi, przy czym przed jego wartością do- 
pisywany jest tekst "BMI: ”. 
Uruchomiony program daje efekt 4 


ż = o X 
Waga (kg) 98 
Wzrost(m| 198 


BMI: 24.687 


aiw 


waż do etykiet 
umieszczonych 
obok pól tek- 
stowych nie 
będziemy się 
odnosić z po- 


B float bmi 


[Ą 1blemi. setText (napis) ; 


rivate void btnObliczActionPertormed (java.awt.event.ActionFvent evt) ( 
LI float waga = Float.parseFloat(tbxWwaga.qgetText ()); 

| B | float wzrost — Float.parsoeFloat(tbxWzrost.getText()); 
= waga/ (wzrost*wzrost) ; 


|D| String napis = "BMI: "+ SLring.valueOf(bmi) ; 
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Automatyzacja 
pracy w Javie 


Java pozwala na pisanie nie tylko aplikacji okienkowych 
czy konsolowych, ale także takich, które okna w ogóle nie 
mają. Tego typu programy mogą na przykład symulować 


działania użytkownika - to boty 


tym rozdziale poznamy zestaw przy- 

datnych poleceń wykorzystywanych 
do zautomatyzowania określonych czynności. 
Skrypty napisane w Javie mogą na przykład 
uruchamiać inne programy, sterować kurso- 
rem myszy czy symulować naciśnięcia klawi- 
szy. Część tych funkcji można wykorzystać 
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na przykład do budowy własnego bota, który 
będzie klikał w określony punkt ekranu (co 
jest przydatne w grach typu „kliker”). Innym 
zastosowaniem może być stworzenie progra- 
mu, który będzie uruchamiał edytor tekstowy, 
a następnie sam wpisze w nim jakiś tekst. I to 
będzie pierwsze zadanie, którym się zajmiemy. 


adam1l3zajacigmail.com 


Bot piszący w Notatniku 


B: stworzyć bota piszącego w Notatni- 
ku, należy utworzyć projekt zgodnie 
z instrukcją z rozdziału 2, jednak bez doda- 
wania do niego JFrame Form - jest to okno 
programu, a nasz program nie potrzebuje 
okna. 


> (© folder 
Gwi+F | jej JavaClas_ 
Gnsx [0 JFrameform. " 


Gm+c [© Panel form 
1 EB lova Package. 


Jawa Interface. 


Delete Delete 


Rafacioc „, © webService Client 


Other... 


Zamiast tego, do projektu należy dodać 
klasę - Java Class 6. Możemy nazwać tę 
klasę PrzykladyZBotem 


Name and Location 


€la55 Name: PrzykladyZBotem 


Project: mavenprojecy 
Locaton: Source Packages 


Package: <0m.mycoMoBNYy.mavenpr oj ect* 


Created Foe: |rojectzynavenprojecthisrcnain java lcomimycompany|mavenprojecPrzykladyzBł 


W przypadku gdy dodajemy do projek- 
tu jedynie plik z klasą, IDE wygeneruje 
początkowo tylko kilka komentarzy, na- 
zwę paczki (package) © i samą deklarację 
klasy. W pliku nie ma konstruktora czy 


metody main. Klasę można wykorzystać 
na wiele sposobów, a w wygenerowanym 
pliku znajduje się niezbędne minimum po- 
trzebne do tego, by zacząć dalsze pisanie 
kodu. 


Uruchomienie Notatnika 

poprzez skrypt 

W przypadku naszego projektu niezbędne 
jest stworzenie metody main - w jej treści 
można zamieścić wszystkie zadania, które 
ma wykonać bot. 


k Rece klasy należy zadeklarować me- 
todę, używając polecenia public static 


void main(Stringl] args) I SE | 


publie class PrzykladyZBotem ( 
public static void main(String[] args) 


, 


t 


Poleceniem String nazwa = „note- 
pad.exe”; € można utworzyć zmienną, 
w której przechowywana będzie nazwa 


public class PrzykladyzBotem ( 
public static void main(String[] args) 
Strinq nazwa = "notepad.cxec"; 


w" 


2 public class PrzykladyZBotem 


package com.myCcompdly.MavenprojecL4; 
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public static void main(String[] args) throws IOException 4 


uruchamianego programu. Założeniem Podanie tego polecenia skutkuje wy- 
jest uruchomienie aplikacji wbudowanej stąpieniem błędu ©. Klikamy na ikonę 
w Windows - Notatnika. Nazwa pliku | błędu, by rozwinąć sugerowane przez IDE 
wykonywalnego tego programu to właśnie | rozwiązania, i wybieramy z listy pozycję Add 
notepad.exe. throws clause for java.io.IOException ©. 


Poprzez polecenie Runtime run = Run- 
time.getRuntime(); © należy utworzyć 
obiekt run klasy Runtime. Obiekt ten pozwo- 


14| [7] public static void main(String 


String nazwa = "noLepad.exl 
Runtime run = Runtime.getR 


li na wywołanie polecenia exec, które umoż- % 
liwia uruchamianie aplikacji. 1 
19 © Surround Statement wth try-catch 
public static void main(Stringl] args) ( 20 © Surround Bbck wth try-catch 
String nazwa = "notepad.exe"; 9 Assign Return Value To New Variable 
Runtime run = Runtime.getRuntime(); 
Polecenia exec używamy w formie: run. Program modyfikuje nieco deklarację 
exec(nazwa); ©. metody main, dodając do niej: throws 


kia slam Makiokiia i IOException 6, ale też automatycz- 


public static void main(String[] args) | nie uzupełnia import odpowied- 
String nazwa = "norepad.exa"; niej biblioteki. 


Runtime run = Runtime.qgetRuntime(); » 
8 


E) import java.io.IOException; 
I 


run.exeoc (nazwa); 


18 ł 
|| as ) Jeśli teraz uruchomimy pro- 
gram (pamiętajmy, że pierwsze 
WY ] TKI uruchomienie programu wymaga określenia 
Ą głównej klasy z metodą main - w tym przy- 
ZCZEWNNEWOECZASZEGOJEEM padku mamy tylko jedną klasę i metodę main 
SEE JUCLENA EfEEEluWatoENOZA w projekcie), po chwili powinien uruchomić 
literówki czy inne pomyłki wynikające się NotatnikeQc 
z pisania. Błędy mogą też wynikać ę : 8 - 
IEDNEWNANCENAWCNENCJCIEM SYmulowanie wciskania klawiszy 
(WYCZENNNENEWEJANJAA SZA Mając uruchomiony Notatnik, można zająć 
WEBREJU JŁEWECHKG HEraweiun| się pisaniem w tym edytorze tekstowym. Pro- 
wyjątkami. Jednym ze sposobów gram powinien mieć możliwość symulowa- 
zgłaszania wyjątków jest polecenie nia różnych zachowań użytkownika - w tym 
UNOWALCYNUWYOCCIELNACIAKYAJCIC OJ wciskania klawiszy. 
ma być zgłoszony. W nagłówku metody 
najpierw należy zadeklarować, jakie typy Java zawiera bibliotekę, która umożliwia 
wyjątków dana metoda może zgłaszać, takie operacje. By móc korzystać z tej 
co robimy za pomocą instrukcji throws, biblioteki, trzeba ją importować. Można to 
WAWIEWEJEG dO UZEGNIANAJACENE zrobić za pomocą polecenia import java. 
COZJESZYZIOWI CO ECENSKUCO NA  awt.Robot; e- 


można je zgłosić, korzystając właśnie 
z instrukcji throw. 


import java.io.IOException; 
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o 


A FLCTTKYNC= 


Project x Files [7 


7) Bez tytułu — Notatnik 


Plik Edycja Format Widok Pomoc 


+ Deotńóen 
di (5 »mowd 
i 4 rdearó 


* © swosamoe 


main - Wavigat.. * "= 

Meder 

= Ś eoórzntem 
© man(stng) args) 22 


6:1 W>-B-O- Ea > 


mannaa mimi mma a a e LU a 


Windows (CRLF) 


Lin 1, kol 1 


nia Document sllet Beana zojectsizavezproject mavenprojecti target 


Następnie w metodzie main można utwo- 

rzyć obiekt klasy Robot - pisząc: Robot 
robot = new Robot(); €. Po wpisaniu ta- 
kiej linii kodu IDE kolejny raz poinformuje 
o błędzie. 


9 Runtime run — Runtime.gotRu 
(U run.exec (nazwa); 
a Robot robot = new_ Robot (|: 
2 ł 

16 public class Przykladyzkotem 4 

9 public static void main(St. 

18 nazwa = "notepad.ex| 
19 Runtime run = Runtime.getR 
20 run.exec (nazwa); 

pi Robot robot = new Robot (); 
22) - 7. Add throws clause tor java.awt.AWTException 
23 © Surround Statement wth try-catch 
24 ©. Surround Block wth try-catch 
AA ze 


Rozwijamy listę sugerowanych moż- 

liwości i wybieramy z niej pierwszą 
opcję - Add throws clause for java.awt.AWT 
Exception 6. Ponownie zostanie nieco zmo- 
dyfikowana definicja metody main, a dzięki 
temu zostanie dodana możliwość obsługi 
wyjątków typu AWTException ©. 


Dodany zostanie też import niezbędnej 
biblioteki import java.awt.AWTExcep- 


tion; = — 


import java.awt.AWTException; 


import java.io.lOException:; 
import java.awt.Robot; 


Operacje wykonywane przez obiekt kla- 

sy Robot mogą mieć pewien interwał. 
Ten odstęp czasu możemy ustawić poprzez 
jego metodę setAutoDelay (która w para- 
metrze przyjmuje czas wyrażony w milise- 
kundach). By kolejne operacje symulowane 
przez obiekt wykonywały się co pół sekun- 
dy, należy użyć polecenia robot.setAuto- 
Delay(500); 


string nazwa = 
Runtime run = 


"notepad.exe"; 
Runtime .getRuntime () ; 
irun.exec(nazwa); 

Robot robot — new RoboL(); 
robot.setAutoDelay (500) ; 


Do symulowania wciśnięcia klawisza 
używa się metody keyPress dla obiektu 
klasy Robot. Metoda ta wymaga podania 
w parametrze kodu (numeru) klawisza, 


public class PrzykladyzBotem 


Strina nazwa = "notenai ava": 


public static void main(String[] args) throws IOException, AWTException ( 
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automatyzacja pracy w Javie 


którego naciśnięcie ma symulować. Tak jak 
w przypadku Arkanoida z poprzedniego roz- 
działu i obsługi sterowania paletką poprzez 
strzałki - nie jest konieczna znajomość nu- 
merów klawiszy, które chcemy symulować. 
Można za to skorzystać z KeyEvent i za po- 
mocą tego obiektu odnosić się do klawiszy 
poprzez ich nazwy. I tak na przykład klawisz 
to KeyEvent.VK_W. Jednak najpierw, by 
KeyEvent było rozpoznawane przez program, 
należy dokonać odpowiedniego importu - 
import java.awt.event.KeyEvent; 


import java.awt.AWTException; 


import java.io.IOException; 
import java.awt.Robot; 


import java.awt.event.KeyEvent; 


7 Załóżmy, że program po uruchomieniu 
Notatnika ma wpisać w nim „jestem 
botem”. By symulować wciśnięcie klawisza 
[J, należy użyć polecenia robot.keyPress- 


robot . 
robot. 
robot. 
robot. 
robot. 


robot 


robot 


robot. 
robot. 
.„.keyPress (KeyEvent. 
keyPress (KeyEvent. 


robot 


robot. 


keyPress(KeyEvent. 
keyPress (KeyEvent. 
keyPress (KeyEvent. 
kceyPress (KcyEvent. 
keyPress (KeyEvent. 
.„.keyPress (KeyEvent. 
robot.keyPress (KeyEvenL. 
.„.keyPress (KeyEvent. 
keyPress (KeyEvent. 
keyPress (KeykEvent . 


VK_J) ; 
VK_E); 
VK S$); 
VK_T); 
VK_E); 
VK_M); 
VK_SPACE) ; 
VK_B); 
VK_O); 
VK_T); 
VK_E); 
VK_M) ; 


(KeyEvent.VK_J); 6. W kolejnych liniach 1 
kodu należy zapisać symulowanie następ- 
nych liter i spacji - tak by powstał napis „je- 
stem botem” ©- 


Beż tu — Noni - ] 


4 wdech Porno 


jestem botem 


wdowi CPLF) Le tei 13 0% 


Uciekający kursor myszy 


nnym zastosowaniem obiektu klasy Robot 

może być stworzenie programu, który bę- 
dzie przemieszczał kursor myszy w losowe 
miejsca. Skrypt ten możemy dopisać do po- 
przedniego przykładu wykorzystania klasy 
Robot, dalej w metodzie main. Zakładamy 
więc, że obiekt robot klasy Robot już istnieje 
i można korzystać z jego metod. 


Ponieważ uciekający kursor będzie prze- 

nosił się w losowe miejsca na ekranie, 
aby uzyskać nową lokalizację dla kursora, 
należy utworzyć obiekt klasy Random ©- 
Za pomocą jego metod będzie możliwe wyge- 
nerowanie losowej (pseudolosowej) pozycji 
dla kursora. 


Random r = new Random(); 


By klasa Random była rozpoznawana 
przez program, należy importować od- 
powiednią bibliotekę 
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import java.awt.AWTException; 


import java.io.lOFxceaption; 
import java.awt.Robot; 
java.awt.event.KeyEvent; 


java.util.Random; 


limport 
import 


Dalej należy poprzez polecenie for (int 

i=0; i<100; i++)[ ) € utworzyć pętlę for, 
która pozwoli na stukrotną zmianę pozycji 
kursora myszy, gdy wewnątrz pętli znajdzie 
się odpowiednie polecenie. 


Random I — new Random() ; 
for (int i=0; i<100; i++)( 


Do wnętrza pętli trzeba wpisać polecenie 
robot.mouseMovefr.nextlnt(1200),r. 


nextlnt(800)); 6, gdzie w parametrach 


uruchomiona jest metoda nextlnt dla obiek- 
tu klasy Random, by wyznaczyć kolejno 
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Random r — new Random(); 


tor (int i=0; i<100; i++)4 


ł 


robot.mouseMove (r.nextInt(1200),r.nextInt(800)); 


setAutoDelay(500); - je- 
śli chcemy, by lokalizacja 
kursora zmieniała się czę- 


współrzędną x i y nowej lokalizacji kursora 
myszy. Liczba 1200 to maksymalna możliwa 
do wygenerowania współrzędna x kursora, 
a 800 - współrzędna y. Możemy też użyć in- 
nych liczb, aby zmienić zakres generowania 
lokalizacji dla kursora. 


Kursor myszy będzie zmieniał swoją po- 
zycję co pół sekundy, gdyż w poprzed- 
niej części programu użyto polecenia robot. 


ściej, użyjmy ponownie po- 
lecenia setAutoDelay bezpośrednio przed 
skryptem napisanym w tej części rozdziału 
i podajmy jako parametr oczekiwany czas 
przerwy między kolejnymi zmianami loka- 
lizacji kursora. 


Program po wykonaniu napisu w No- 

tatniku powinien teraz co pół sekun- 
dy przemieszczać kursor myszy w nowe 
miejsce. 


Przydatne metody klasy Robot 


lasa Robot to nie tylko metody zaprezen- 

towane w przykładach. Obiekty tej klasy 
mogą robić też inne przydatne rzeczy. 
Wśród możliwości klasy Robot jest też two- 
rzenie zrzutów ekranu czy sprawdzanie ko- 
loru piksela na ekranie w określonych ko- 


ordynatach. To sprawia, że klasa Robot jest 
idealnym narzędziem do budowy botów. By 
lepiej się z nim zapoznać, możemy spróbo- 
wać zbudować bota do gry typu „kliker” (po- 
legającej na klikaniu na określony przycisk 
w celu zdobywania punktów). 


METODA OPIS 


delay (int ms) 


keyRelease (int keycode) 


mousePress (int buttons) 


mouseWheel (int wheelAmt) 


Pozwala na zatrzymanie programu na określony w milisekundach czas podany 
w parametrze metody. W przeciwieństwie do setAutoDelay wykonuje się 
jednorazowo, a nie po każdej czynności. 


Analogicznie do keyPress - symuluje puszczenie określonego klawisza. 
Symuluje wciśnięcie przycisku myszy. Dla lewego przycisku myszy należy uruchomić 
ją z parametrem InputEvent.BUTTON1_MASK. 


Symuluje kręcenie kółkiem myszy - parametr oznacza liczbę przekręceń. Liczba 
ujemna oznacza kręcenie w górę, a dodatnia w dół. 


DOKUMENTACJA DO JAVY 


By wykorzystać pełnię możliwości, jakie 
dają nam różnego rodzaju biblioteki, najle- 
piej zapoznać się z ich dokumentacją. Por- 
tal, gdzie znajduje się dokumentacja do 
blibliotek Java, znajduje się pod adresem 
docs.oracle.com/en/java. Z łatwością 


wyszukamy tam także dokumentację do 


SUMMARY NESTED | FIFLD | COASTR | METHOD 


Method Summary 
Mocifier and Type Method 
Maltifesoluticelcage  crestefiultiResoluticn$<reenlaptareiRetangle screenaect 


biblioteki java.awt.Robot _. Dzięki niej 
poznamy więcej możliwości tej biblioteki. 
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Podstawy tworzenia 
projektów 3D w Javie 


Często główną przyczyną podjęcia decyzji o rozpoczęciu nauki 
programowania jest chęć tworzenia gier z grafiką 3D. 

Z tego rozdziału dowiemy się, jakie kroki podjąć, by móc 
tworzyć takie projekty, znając Javę 


Minecraft 


inecraft jest grą o bardzo prostym założe- 
niu. Oto gracz zostaje umieszczony w lo- 
sowo generowanym świecie, który zbudowa- 
ny jest z sześcianów, mających różne tekstury. 
Gracz może niszczyć bloki, stawiać nowe, ata- 


kować napotkane istoty, zbierać surowce czy 
wytwarzać przedmioty. Z kolejnymi wersjami 
gry jej możliwości rosną, a produkcja już teraz 
mocno różni się od wersji zaprezentowanej 
podczas premiery w 2011 roku. 


Scena z gry Minecraft 
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Twórca gry Minecraft, Markus Persson 
„Notch”, rozpoczął pracę nad produkcją 
10 maja 2009 roku. Już tydzień później uka- 
zała się otwarta wersja testowa projektu. Do 
oficjalnej premiery w 2011 roku zespół pro- 
gramistów pracujących nad grą Minecraft 
rozrósł się, w międzyczasie powstała także 
firma Mojang AB, która oficjalnie odpowia- 
dała za Minecrafta. 

Minecraft odniósł ogromny sukces, na stałe 
znajdując miejsce w świadomości mnóstwa 
ludzi, szczególnie wśród dzieci. Na fali popu- 
larności gry na rynku zaczęły się pojawiać 
różnego rodzaju produkty powiązane z jej 
światem. I tak Minecraft to teraz także mię- 
dzy innymi seria klocków LEGO, zabawki, 
seriale, książki i magazyny. Firma Mojang AB 
została przejęta przez prawdziwego giganta 
IT - firmę Microsoft. Wartość transakcji opie- 
wała na 2,5 miliarda dolarów. Ta ogromna 
kwota robi wrażenie. Nic dziwnego, że wielu 
fanów tej produkcji chciałoby także stworzyć 
taką grę i odnieść podobny sukces. 
Dlaczego w książce o Javie pojawia się hi- 


LWJGL 2, jednak obecnie na rynku jest do- 
stępna nowsza wersja tej biblioteki z gałęzi 
LWJGL 3. 


Obecnie biblioteka LWJGL jest dostępna 
w wersji 3.2.3. By użyć tej biblioteki w swoich 
skryptach, należy pobrać ją ze strony o adresie 
www.lwjgl.org i dołączyć do projektu. 

Aby umożliwić zapoznanie się z działaniem bi- 
blioteki i sposobem korzystania z niej, twórcy 
przygotowali przykładowe skrypty szkolenio- 
we. Znajdziemy je pod adresem www.lwjgl. 
org/guide ©. 
Jeden z przykładów to składający się z wielu 
linijek kod, którego działanie polega na stwo- 
rzeniu okna gry i wypełnieniu go czerwonym 
kolorem. 

Twórcy przygotowali też zestaw projektów 
bardziej zaawansowanych - dema pokazują: 
ce działanie biblioteki w praktyce. Możemy je 
pobrać także ze strony www.lwjgl.org/guide, 
przechodząc nieco poniżej przedstawionego 
skryptu. 


storia Minecrafta? Dlatego że 
właśnie w tym języku progra- 
mowania został stworzony 
Minecraft. 


A konkretnie wykorzystano 
do tego LWJGL, czyli Light 
Weight Java Game Library. 
To zewnętrzna biblioteka 
przeznaczona do tworzenia 
gier. W przypadku Mine- 
crafta zastosowano ją do 
wyświetlania grafiki, odtwa- 
rzania dźwięku oraz obsługi 
urządzeń wejściowych (kla- 
wiatura, mysz itp.). LWJGL 
łączy w sobie między innymi 
zastosowania do celów gra- 
ficznych (OpenGL, Vulkan), 
dźwiękowych (OpenAL) 
i obliczeń równoległych 
(OpenCL). Do tworzenia 
Minecrafta wykorzystano 


import static 
import static org |ck.*; 
import static org. lwjgl .system.Mesoryvti1.*; 


public class Helloworld ( 


private long window; 


run() ( 
System.out .println("Hello LWJGL * + Version.getvVersion() + "1"); 


init(); 
loop(); 


glfwFreecal lbacks (window); 


glfwoestroywindow(window) ; 


glfwTerminate(); 
glfwSetErrorCallback(nul1).free(); 


init() ( 
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podstawy tworzenia projektów 3D w Javie 


Silnik gier jMonkeyEngine 


programowaniu dąży się do | © 


maksymalnego uproszczenia |< c 


procesu kodowania. W przypadku 
LWJGL kodowanie jest dość skom- 
plikowane. Skrypty są długie i na 
pierwszy rzut oka trudno je zrozu- 
mieć. Dużo jest tam subtelności i każ- 
dy drobiazg może mieć duże znacze- 
nie. W celu uproszczenia pracy, na 
przykład z projektami 3D, powstaje 
wiele silników gier. To narzędzia 
oparte na językach programowania 
i wprowadzające wiele mechani- 
zmów właściwych dla konkretnego języka, 
jednak ułatwiających tworzenie rozbudowa- 
nych projektów. 

Jednym z takich silników jest ]JMonkeyEngine. 
Narzędzie to oparto właśnie na LWJGL, jednak 
by z niego korzystać, nie trzeba znać zawiłych 
mechanizmów tej rozbudowanej biblioteki. 


By rozpocząć pracę z tym silnikiem, nale- 
ży wejść na stronę https://jmonkeyen- 
gine.org i kliknąć na przycisk Get Started ©. 


Następnie, klikając na przycisk Download 

the SDK EJ, pobieramy narzędzie wzoro- 
wane na NetBeans IDE, jednak zawierające 
w sobie silnik jMonkeyEngine. 


Po instalacji pobranego narzędzia klika- 
my na przycisk New Project ©, by utwo- 
rzyć nowy projekt. 


W nowo otwartym oknie, w sekcji Cate- 
gories, wybieramy JME3 IE], a w sekcji 


Monkeyfngine x + 


Q 4 j|monkeyengine.org 


e 


Afree, open source game engine, mz 
modern technology. The software is 
deployment. 


Get Started > 


Projects klikamy na BasicGame [H. Zatwier- 
dzamy wszystko, klikając na Next []. 


Ę W kolejnym kroku możemy określić na- 
zwę nowego projektu oraz lokalizację [H, 
w której zostanie zapisany. Projekt zostanie 
utworzony, gdy klikniemy na Finish. 


© |MonkeyEngqine SDK 3.3.0-v3.3.0: 


By zapoznać się 

z początkową, wy- 
generowaną przez pro- 
gram treścią projektu, 
musimy rozwinąć 
drzewo z pakietem - 
jak w NetBeans IDE - 
by dostać się do pliku 
Main.java ©. 


f% jMonkeyEngine SDK 3.3.0-v3.3.0-beta1-sdk1-SNAPS 
File Edit 


2360r2B% DE 


View  Navigate Source  Refactor 


New Project... (Ctri+Shift+N) 


kJ 
. 

Quick Start 
There are a variety of ways to use jMonkeyEngine 

* Download the SDK 

« Download the engine 

 Addthe libraries to a build script 
Using the Netbeans-based SDK is by far the quickest solution to get you up and running. Everything needed is provided. along with extra tools and integrations. and is 
generally the place most users start their endevour. Download the SDK 
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W pliku znajduje się | © "ies 


baza projektu z gra- |EEB ChooseProject 


fiką 3D. Wygenerowa- KSGSZZS 
ny skrypt zawiera opis [Ę 
tworzenia niebieskiego 
sześcianu. Uruchamia- 
my program, klikając na 
przycisk Run project 


Okno graficzne 
aplikacji stworzonej 
przez silnik jMonkeyEn- 
gine nie od razu poka- 
zuje nam to, co zostało 
zapisane w widocznym 


skrypcie. Najpierw wy- | © NexProjea 

świetlony jest ekran [IF No rS= 
z informacją o użytym JĄ 
silniku, ekran ten po- „. Name and Location Project Name E 
zwala także na dokona- Project Location 
nie zmian dotyczących c 
grafiki, między innymi 
rozdzielczości, korekcji 


<default config> T "w h ki reaóeowmi 4% L. 


| Welcome Ścreen_ « NSJSDDYNZW Run Project (BasicGame) (F6) 


Gamma czy głębi koloru. By przejść do głów- 
nej treści programu, klikamy na przycisk Con- 
tinue 


jMonkeyEngine 3.3.0-beta1 


5©'een Resoluton 640 x 400 


Refresh Rate 


Właściwe okno aplikacji ze skryptu zawie- 

ra już wspomniany niebieski sześcian ©. 
Możemy oglądac go z różnych stron. Widokiem 
można sterować z wykorzystaniem kursora my- 
szy, a także klawiszy (W, (A), B], CJ. 
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podstawy tworzenia projektów 3D w Javie 


[O Vieiceme Screen *JHETNNÓE 
[LE BEZELE 


Source History 


+ This is the Main Class of your Game. Y 
* Move your ppStates or Cont 
* Gauthor r 


Przyjrzyjmy się jeszcze treści pliku 
Main.java. Po jego otwarciu zoba- 
czymy krótki skrypt ©, którego zadaniem 
jest wyświetlenie w oknie programu nie- 


bieskiego sześcianu. Klasa Main dziedziczy 


po klasie SimpleApplication, która jest bazą 
dla projektów w jMonkeyEngine (patrz też 
strona 64). 


Jak samodzielnie tworzyć obiekty 3D 


azując na tym, co dostarcza startowy 

projekt jMonkeyEngine, można zaprojek- 
tować bardziej rozbudowaną scenę. Takich 
sześcianów może być więcej - zobaczmy, jak 
je stworzyć. 


Do metody simplelnitApp dopisujemy li- 
nijkę Geometry geom2 = new Geome- 
try(”Box”, b); 7.1. Utworzymy w ten sposób 
nową geometrię bazującą na wcześniej utwo- 
rzonym sześcianie. W ten sposób możliwe bę- 
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dzie dodanie w oknie projektu kolejnej kostki 
o tych samych wymiarach, jednak z przypi- 
sanym innym materiałem - będzie ona miała 
inny kolor. To właśnie materiał nadaje wygląd 
obiektom. Bez pokrycia obiektu materiałem 
nie byłoby go widać. 


Poleceniem Material mat2 = new Ma- 

terial(assetManager, Common/Mat- 
Defs/Misc/Unshaded.j3md"); [:1 tworzy- 
my nowy materiał. 
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public ) 


£ 


DE 


oid simplelnitApp( 
(1 1 


Geometry geom2 — new Geomet ry( "Box" 
Material mat2 = new MateriaLl( 
mat2.setCotor(" ColorRGBA .Re 


By materiał nie był „pusty”, należy przy- 
pisać do niego kolor, co można zrobić 
poleceniem mat2.setColor("Color", Color- 
RGBA.Red); (1. W przykładowym poleceniu 
przypisywanym kolorem jest czerwony, jeśli 


riew Geomet ry( 
= Material(a 


shaded.j3md"); 


, 


UFA - 


z nich. Można to zrobić poleceniem geom2. 
move(2,0,0); [7] (patrz kolejna strona) - wtedy 
czerwona kostka przesunie się o dwie jednost 
ki na osi X (co oznacza przesunięcie w pra- 
wą stronę). Srodkowa liczba w parametrze 


w miejsce Red podamy inną angielską nazwę 
koloru, to ten właśnie kolor zostanie ustawio- 
ny w materiale. 


Dopisujemy jeszcze geom2.setMateria- 
I(mat2); [7], by utworzona wcześniej geo- 
metria została pokryta nowym materiałem. 


Poprzez polecenie rootNode.attach- 
Child(geom2); [-3 dodajemy czerwoną 
kostkę do grafu sceny. 


Gdy dodajemy obiekty do grafu sceny, do- 
myślnie trafiają one w jedną lokalizację na 
środku układu współrzędnych. By dwie kostki 
- niebieska i czerwona - nie znajdowały się 
w tej samej lokalizacji, trzeba przesunąć jedną 


metody move mówi o przesunięciu na osi Y 
(góra-dół), a ostatnia - na osi Z (przód-tył). 


Po uruchomieniu projektu zobaczymy 
dwa sześciany w różnych kolorach 


4 
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podstawy tworzenia projektów 3D w Javie 


Jeszcze więcej sześcianów 

W ramach ćwiczenia możemy spróbować 
tworzyć graficzne kostki w pętli, a nawet 
w pętlach - by było ich więcej ©. Zapre- 


© |vonkeytngine 3.30-veta1 


zentowany efekt można uzyskać, doprowa- 
dzając kod do następującej postaci ©. Two- 
rzenie kostek można też zapętlać na inne 
sposoby, by osiągnąć jeszcze inne efekty. 


0id simplelnitApp() 4 


Geometry 
M ą 
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Klasa SimpleApplication 

Klasa SimpleApplication zawiera wiele cieka- 
wych mechanizmów. To ona odpowiada za 
pierwszoosobowy widok i możliwość sterowa- 
nia kamerą; dostarcza graf sceny umożliwiający 
zarządzanie renderowanymi modelami 3D oraz 
mapowanie wejścia w celu sterowania kamerą. 
By lepiej zapoznać się z działaniem tej klasy, 
warto przyjrzeć się znajdującym się w niej po- 
lom i metodom opisanym w tabelce obok. Nie 
są to jedyne pola i metody, jakie zawiera klasa 
SimpleApplication, bo ona sama dziedziczy 
sporo zawartości po klasie Application. 


Mapowanie wejścia 

Klasa dziedzicząca po SimpleApplication ma 
w sobie wbudowaną obsługę wielu klawiszy 
i myszy. Za co odpowiadają poszczególne klawi- 
sze? Część z nich służy do sterowania kamerą. 
Sterować kamerą można także myszą - przesu- 
wając kursor. Przybliżanie i oddalanie się można 
zrealizować poprzez przekręcanie kółka myszy. 
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NAZWA POLA/ METODY OPIS 


To pole klasy będące grafem elementów sceny. Przyjrzyjmy się metodzie 
simplelnitApp - w niej, dla obiektu rootNode, uruchamiana jest metoda 


rootNode attachChild. Utworzony wcześniej niebieski sześcian za pomocą tej metody 
jest dodawany do grafu elementów sceny. 
To kolejne pole klasy, które służy do dodawania elementów okna gry. W tym 

guiNode wypadku są to jednak elementy płaskie, nietrójwymiarowe, takie jak ikony, 
napisy czy paski. 

fiyCam Dzięki temu polu klasa obsługuje kamerę, co daje możliwość obserwacji 


sześcianu z różnych perspektyw. 


To metoda, która pozwala na umieszczenie w oknie projektu statystyk 

A dotyczących działania aplikacji. Jest to szczególnie przydatne podczas 
loadStatsView() tworzenia i sprawdzania działania aplikacji, a nieco mniej, gdy już gotowy 
program trafia do użytkownika. 


IoadFPSText() | wywołanie umieszcza na ekranie bieżącą liczbę fps (klatek 


Bieżąca liczba fps (klatek na sekundę) jest domyślnie widoczna na ekranie, 
mimo że w skrypcie, jaki silnik udostępnia programiście na start pracy nad 
setDisplayFps(false) nową grą, nie ma bezpośredniego wywołania metod za to odpowiedzialnych. 
Użycie metody setDisplayFps z parametrem false powoduje ukrycie tej 
domyślnie widocznej wartości. 


Analogicznie jak w wypadku poprzedniej metody - w ten sam sposób można 
setDisplayStatView (false) ukryć wszystkie statystyki (poza fps, które wymaga oddzielnego polecenia) 
widoczne domyślnie w oknie gry. 


To metoda, którą w implementacji klasy dziedziczącej po SimpleApplication 
należy nadpisać - to właśnie w niej tworzy się elementy okna i umieszcza je 


simplelnitApp() na scenie (dodaje do grafu sceny). Metoda ta jest nadpisana 
w przykładowym skrypcie i to właśnie w jej treści utworzony jest niebieski 
sześcian. 
Kolejna metoda, którą trzeba nadpisać. Wszystkie operacje w niej 
simpleUpdate(float tpf) umieszczone są wykonywane w pętli. Częstotliwość ich wykonywania wpisuje 


się w nawiasie w formie parametru. 


Metoda, którą również należy nadpisać. Pozwala ona na modyfikowanie 
simpleRender(RenderManager rm) | bufora ramki (to część pamięci RAM) i jest przeznaczona do wykorzystywa- 
nia przez doświadczonych programistów. 


ALTERNATYWA DLA JMONKEYENGINE — LIBGDX 


Innym popularnym narzędziem do 
tworzenia gier 3D w Javie jest libGDX. 
Framework ten jest wykorzystywany 
zarówno przez wielu niezależnych progra- 
mistów, jak i przez największe korporacje 


IT, w tym Google (przykładem jest tu gra 
z gatunku MMO - Ingress). Oceniając 
możliwości silnika gier, najlepiej spraw- 
dzić, jakie efekty da się w nim osiągnąć. 
Co można zrobić w libGDX, zobaczymy 
pod adresem https://libgdx.badlogic- 
games.com/gallery.html 


JAVA ZACZNIJ PROGRAMOWAĆ 65 


adam1l3zajac(gmail.com 


Java na Androida 


Jedną z głównych przyczyn popularności Javy jest to, 
że wykorzystuje się ją do tworzenia aplikacji na system 
operacyjny Android. W tym rozdziale poznamy podstawy 


tworzenia aplikacji mobilnych 


Android Studio 


M ówiąc o tworzeniu aplikacji na Andro- 
ida, należy zwrócić uwagę na opro- 
gramowanie, jakie możemy w tym celu 
wykorzystać. Firma Google zaproponowała 
programistom dedykowane rozwiązanie. To 
program Android Studio 
ERNZAEJUVD. Nie oznacza to, że nie istnieją 
dla niego alternatywy. Aplikacje na Androida 
można tworzyć także poprzez inne progra- 
my, jak NetBeans czy Eclipse 
(AUANHA) - wymaga to jednak odpowied- 
niego przygotowania tych narzędzi. 

Jednak do pierwszego kontaktu z programo- 
waniem na Androida najlepiej sprawdzi się 
dedykowane środowisko, dlatego wskazówki 
przedstawione w tym rozdziale zostały opar- 
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te na programie Android Studio, który można 
zainstalować z płyty dołączonej do książki. 


KOTLIN 


W 2019 roku język programowania 
Kotlin zastąpił Javę jako preferowany 
przez Google język tworzenia aplikacji 
na Androida. Kotlin - działający na 


maszynie wirtualnej Javy — został zapro- 
jektowany jako przemysłowy, obiektowy 
język w pełni interoperacyjny z kodem 
napisanym w Javie, pozwalając firmom 
na stopniową migrację bazy kodu z Javy 
do Kotlina. 
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Android SDK 


I ie jak do programowania w samej Javie 
potrzebne jest JDK, tak do programowa- 
nia dla Androida należy zaopatrzyć się w An- 
droid SDK. Co ważne, jest ono instalowane 
wraz z Android Studio. Android SDK składa 
się z dwóch części: SDK Tools - wymaganej 
do tworzenia aplikacji niezależnie od wersji 
Androida, oraz Platform Tools, czyli narzę- 
dzi zmodyfikowanych pod kątem konkret- 
nych wersji systemu. 


W skład tej pierwszej części wchodzą między 

innymi: 

m android - pozwala zarządzać wirtualnymi 
maszynami (AVD ManagepD, projektami, 
modułami SDK (Android SDK Manager), 

m ddms (skrót od Dalvik Debug Monitor 
Server) - debugger (nazwa ta oznacza 
program komputerowy służący do dyna- 
micznej analizy innych programów w celu 
odnalezienia i identyfikacji zawartych 
w nich błędów, które z angielskiego na- 
zywane są bug, co można przetłumaczyć 
jako robak), 

m emulator - emulator urządzenia z Andro- 
idem, którego można użyć do testowania 
stworzonych aplikacji pod różnymi wersja- 
mi systemu; tworzy on wirtualne środowi- 
sko Androida na komputerze, 

m sqlite3 - pozwala uzyskać dostęp do pli- 
ków baz danych SQLite, 

m layoutopt - analizuje layout (wygląd, 
rozmieszczenie elementów) aplikacji 
w celu zoptymalizowania ich pod kątem 
wydajności, 

m ProGuard - zmniejsza, optymalizuje i za- 
ciemnia kod poprzez usuwanie nieużywa- 
nych fragmentów oraz zmianę nazw klas, 
metod i pól, 

m mksdcard - pozwala utworzyć obraz dys- 
ku możliwego do użycia z emulatorem, co 
ma symulować obecności zewnętrznej pa- 
mięci (przykładowo karty SD), 

m traceview - graficzna przeglądarka lo- 
gów wykonania aplikacji; log jest chro- 


nologicznym zapisem zdarzeń i działań 
użytkownika programu; takie pliki są 
pomocne w zlokalizowaniu problemów 
z oprogramowaniem zgłaszanych przez 
użytkowników, 

m zipalign - optymalizuje pliki APK - An- 
droid Package Kit to format pliku będący 
odmianą formatu JAR, używany do dystry- 
bucji i instalacji pakietów na system opera- 
cyjny Android. 


W drugiej części znajdują się: 

m Android Debug Bridge - wszechstronne 
narzędzie, które pozwala na kontrolowanie 
emulatora lub urządzenia z Androidem, na 
którym testowane są projekty, 

m fastboot - program umożliwiający takie 
operacje, jak instalacja nowszej wersji An- 
droida lub nawet innego systemu, zarzą- 
dzanie partycjami czy odblokowywanie 
bootloadera. 


Używanie jakiegokolwiek IDE do progra- 
mowania w Javie dla Androida nie jest obo- 
wiązkowe. Można edytować pliki tekstowe 
w dowolnym edytorze, a później budować 
i debugować aplikację za pomocą konsolo- 
wych narzędzi dostarczanych z SDK - ana- 
logicznie jak w wypadku JDK. 


Activities - aktywności 

Activities to po polsku aktywności. Moc- 
no upraszczając, aktywności są wykorzy- 
stywane do interakcji programu z użyt- 
kownikiem. A taka interakcja następuje 
poprzez okno aplikacji. I takie właśnie 
poszczególne okna programu nazywa się 
aktywnościami. Dzięki ich zastosowaniu 
możliwa jest optymalizacja programu - nie 
wczytuje się wszystkich jego elementów 
jednocześnie, ale kolejno, dopiero wtedy, 
gdy trzeba je wyświetlić. Ważnym elemen- 
tem zastosowania aktywności jest też moż- 
liwość cofania się do poprzednich okien 
z zachowaniem ich stanu. 
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Java na Androida 


Jak stworzyć projekt 


| My Application [D.Users(MyApplication] - 


Aappisrcymainijavaicomiexampie|myapplic: 


U ając już zainstalowane Android 
H Studio, można przejść do utwo- 
rzenia pierwszego projektu. 


or debug APK Project fr 


> New Module 


4] Po uruchomieniu narzędzia roz- 
zła wijamy z paska menu pozycję File 


Ś Settings Ctrl+Alt+S 


i wybieramy New, a następnie New PERSISTENT 
Project 


4£%VW nowym oknie program HESS 
ć2 poprosi o wybór początko- 
wej aktywności, co ma przeło- 
żenie na schemat okna, od ja- 
kiego można zacząć prace nad 
projektem. Na początek najlepiej 
wybrać opcję Empty Activity ©, 
w której okno początkowe będzie 
puste. Dzięki temu łatwiej nam 
będzie odnaleźć się w projekcie 
i samodzielnie budując kolejne 
jego elementy, poznawać działa- 
nie programu. Wybór należy za- HPRRPRR 

twierdzić przyciskiem Next ©, co NEROSE 
spowoduje przejście do kolejnego 
kroku tworzenia nowego projektu. 


4 Oprócz określenia na- 
zwy projektu można 
teraz między innymi wy- 
brać minimalną wersję 
systemu Android, z którą 
zgodny ma być tworzony 
POZA projekt. Część możliwo- 
ści nie jest dostępna dla 
starszych wersji systemu. 
Z reguły powinno się 
wybierać najniższą wer- 
sję systemu pozwalającą 
Android A na stworzenie aplikacji 
roimatey 100% of derice zgodnej z założeniami. 
Dlatego trzeba wiedzieć, 
jakie możliwości mają 
kolejne wersje Androida. 
By to sprawdzić, można 
kliknąć na przycisk Help 
me choose 


Configure your project 


Name 


My Application 


Previous 
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4 Program z wyświetli ANDROID PLATFORM API LEVEL CUMULATIVE lce Cream Sandwich 
"EF zestawienie wersji An- VERSION DISTRIBUTION 
droida wraz z dodanymi e 
do nich możliwościami. 88,1% 
Klikając na przycisk OK ©, "m 95,9% 
zamkniemy nowe okno, Ed. 
a aktualnie wyświetlana 

wersja systemu trafi do 

pozycji Minimum API le- 

vel [J. Wybór ten można 

jednak jeszcze zmienić, 
wybierając inną wersję 

z rozwijanej listy ©. 

kładamy, że w przypadku 

naszego pierwszego pro- 

jektu nie potrzebujemy 
zaawansowanej funkcjo- 

nalności, dlatego możemy wybrać 
najstarszą wersję systemu. 


Cantaxas Prowkder Nacessi LABRY 


Minimum API level | API 23: Android 6.0 (Marshmallow) 


W Your app wiii rL 


Help me choose API 17: Android 4.2 (Jelly Bean) 


Całość „zatwierdzamy przyci- - tyją 27! 18: Android 43 ly Bean) 
skiem Finish [-], co prowadzi do s project wii! Apl 19: Android 4.4 (Kitkat) 
utworzenia projektu. Może to chwilę Use androidx* a Ap] 20: Android 4.4W (KitKat Wear) 
potrwać, jednak po pewnym czasie 


API 21: Android 5.0 (Lollipop) 
. R E API 22: Android 5.1 (Lollipop) 
pojawi się okno ze skryptem MainAe- API 23: Android 6.0 (Marshmallow) 


tivity.java 
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fi ednocześnie powinna też zostać otwar- 
WD ta druga zakładka z plikiem activi- 
ty_main.xml ©. Jest to plik formatu XML. 
Nazwa tego formatu to skrót od Extensible 
Markup Language, co można przetłumaczyć 


activity_main.xml 


jako Rozszerzalny Język Znaczników. XML 
to uniwersalny język znaczników, który 
przeznaczony jest do reprezentowania róż- 
nych danych w strukturalizowany sposób. 
W przypadku tego pliku reprezentuje on 
wygląd aktywności. 

Tworząc aktywności, należy tak naprawdę 
utworzyć dwa pliki - jeden napisany w XML 
z opisem wyglądu i drugi w Javie z opisem 
działania tej aktywności. 


Emulator z maszyną wirtualną 


P rzed rozpoczęciem właściwej pracy nad 
I projektem warto zadbać o środowisko 
testowe dla tworzonego programu. Testy 
można prowadzić zarówno na rzeczywistym 
urządzeniu podłączonym poprzez kabel USB, 
jak i na emulatorze. Emulator jest częścią 
Android SDK, ale trzeba jeszcze mieć sam 
system Android w odpowiedniej wersji, by 
móc uruchomić go w emulatorze. 


1 Klikamy na przycisk AVD Manager 
mila znajdujący się na pasku po prawej stro- 
nie, u góry okna programu. Otwiera on okno 
menedżera wirtualnych urządzeń. 

% W nowym oknie klikamy na przycisk 
Śa Create Virtual Device © - by przejść do 
tworzenia wirtualnego urządzenia. 


Program pozwala na wybranie modelu 
19 urządzenia, jakie ma być emulowane. 
W oknie mamy do wyboru nie tylko smartfo- 
ny £Vi tablety [-1, ale także inteligentne ubra- 
nia [H] czy telewizory [£]. Takie urządzenia 


WOCTBE 


test your application without having to 


To priocitize which « 


whśch devices are activ 


też można emulować, bo przecież i na nie 
można tworzyć aplikacje poprzez Android 
Studio. W naszym przykładzie wybieramy 
jeden z modeli smartfonów, którego pracę 
będziemy emulować na komputerze. Modele 
te różnią się głównie rozdzielczością i wielko- 
ścią ekranu. Po dokonaniu wyboru jednego 
ze smartfonów klikamy na przycisk Next ©, 
aby móc potwierdzić wybór i przejść do ko- 
lejnego kroku. 


app v || [; NexusSAPI22 w 


le” | © Default (en-us) 7 19% © 
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Select Hardware 
Android Studio 


A 


Choose a device definition 


Category Name v 


"BI 


Phone 


Pixel X 
Pixel 3a XI 
Pixel 3a 


Pixel 3 XL 


1080x1920 


New Hardware Profile Import Hardware Profiles 


Następnie należy wybrać wersję syste- 
mu do emulowania, a potem ją pobrać. 
Przy wersjach Androida widocznych na li- 
ście są przyciski Download © - klikamy na 


System Image 


Android Studio 


Select a system image 


Recommended _ xB6lmages Other Images 


Release Name API Level v 


LZ 
Oreo 

Nougat 
Nougat 
Marshmallow 


Lollipop 


($ Pixel 2 


Rate 


S60dpi 


420dpi 


Qlone Dence. 


jeden z nich. Nie ma dużego znaczenia, któ- 
rą z rekomendowanych wersji pobierzemy. 
Gdy zostanie ona już pobrana, zaznaczamy 
ją i klikamy na Next ©, by przejść dalej. 


Lollipop 


5.1 
Google Inc. 


System image 


x86 


Android 5.1 (Google APIS) 


mmend these images because they run the fastest 


t Google APIs 


estions on API level? 
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_5 Android Virtual Device (AVD) 
AA Android Studio 
Verify Configuration 
AVD Name 


[z] Ne 
1. 


Nexus One API 22 


Change 


Change... 


Lollipop 


Startup orientation | W 


Automatic 


Device frame Ww) Enable Device frame 


Show Advanced Settings 


[EW kolejnym kroku możemy między inny- 
© mi nadać nazwę © swojemu wirtualnemu 
urządzeniu, ale też zmienić decyzję dotyczą: 


Default Orientation 


ation of the device. During AVD emulation you can also rotate 


cą modelu i wersji systemu, które zostały wy- 
brane w poprzednich krokach. By wszystko 


zatwierdzić, klikamy na przycisk Finish 


Program na Androida: generator liczb 


5 y zapoznać się z programowaniem na 
| Androida, stworzymy prostą aplikację 
generującą sześć unikalnych liczb. Taką apli- 
kację można zastosować do wytypowania 
liczb w popularnej loterii, w której należy 
postawić na sześć liczb z zakresu 1-49 wylo- 
sowanych przez maszynę losującą. 


Budowa interfejsu 
Pracę nad projektem można rozpocząć od 
pliku XML. Można go edytować na dwa 
sposoby - graficznie i tekstowo. Domyślnie 
otwarta zostaje edycja graficzna. Pomiędzy 
sposobami edycji można przełączać się przy- 
ciskami Design [Li Text [-] u dołu sekcji po 
lewej stronie. 
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gD w tej aktywności znajduje 
ziłu się na ekranie komponent TextView 
z napisem Hello World, który można usu- 


nąć. Wystarczy zaznaczyć element w sekcji 
Component Tree [Hi nacisnąć klawisz Gaj 


% Zamiast usuniętego właśnie elementu 
a można dodać przycisk. Z sekcji Palette 
przeciągamy Button na podgląd aktywności. 


© MainActivity 


a$g-: 


actwity_mainxml > 
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śctiwty_mainoxmni © Mainactity java 


— 2 Ov UPued” m 


©: up, LŹ I 


29% © AppThneme” 


onstraintLaycut 


Ab TextView- "He 


Co ważne, miejsce, w którym widać 

przycisk, jest tylko poglądowe. Po uru- 
chomieniu programu, bez wprowadzenia 
drobnych zmian w pliku XML, przycisk po- 
wędrowałby w lewy górny róg ekranu. 


Przełączamy się zatem do trybu tekstowe- 
go, klikając na przycisk Text 


Teraz dla znacznika odnoszącego się do 

komponentu Button możemy zmody- 
fikować android:layout_height i andro- 
id:layout_width, zmieniając ich wartość 
z wrap_content © na fill_parent ©, dzięki 
czemu przycisk zostanie rozciągnięty na całe 
okno programu. 

[c) MainAclivily.java 


sion=" " encoding=" 


© Delawit (en-us) Y 


r absoluteX="164cdpn" 


_absoluteY—"33 


Będąc już w pliku XML, należałoby do- 

pisać do niego, by naciśnięcie przycisku 
skutkowało wywołaniem metody. Można to 
osiągnąć, dopisując do pliku XML w sekcji 
odpowiedzialnej za przycisk 6 - android:on 
Click="onClick" ©, gdzie w cudzysłowie po- 
dana jest nazwa metody wywoływanmej zdarze- 
niem naciśnięcia przycisku. 


<kandroidx.constraintlayout.widget.ConstraintLayout xmlns: 


:layout_hei 


1d:text""Bu 

: layont_editor_ahsoluteX=" 

:layout_ editor _absoluter—"33 
23 


</androidx.constraintlayout.widget.ConstraintLayout> 
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48 ąctińity_mainami © maina 


d:id="G+i t 
:layout_ width 
d:layout_height=" 
android:text 
s:layout_editor_absolutex 
)lsslayout editor absoluter=" 


android:onClick 


pliku Javy, w którym znajdzie się już wyge- 
nerowana metoda onClick © - cokolwiek 
w niej napiszemy, wykona się po naciśnięciu 
przycisku. 


zg Przycisk ten oprócz tego, że został rozciąg- 

A nięty na cały ekran, pozostałe ustawienia 
ma domyślne, łącznie z napisem. W pliku 
XML zmieniamy android:text="Button" na 
android:text="Generuj” ©, co sprawi, że na 
przycisku pojawi się napis Generuj. Wszyst- 
kie zmiany wprowadzane w pliku XML są na 
bieżąco widoczne na podglądzie 


Ueilinicja m ( 
Przed przystąpieniem do pisania powinni- 
śmy zrozumieć algorytm działania metody. 

myrstcyszzwcze Należy losować sześć liczb z puli 1-49. Nie 
_absolutet="3 mogą to być tylko liczby (pseudo)losowe 
z tego zakresu, ponieważ wartości wybra- 
nych sześciu liczb nie mogą się powtórzyć. 
Wygenerowane liczby spełniające założenia 
s Owenide Resource in Other Gonfiguration= zadania będą umieszczane na liście. To ko- 
*7 Rearrange tag attnbutes lekcja podobna do tablicy, jednak deklarując 
7 Remove attribute ją, nie trzeba określać jej rozmiaru. Dopóki 
żalecć angusge ogreżcteroą na liście nie znajdzie się sześć liczb, będzie 


7 Create onClick event handler w 


Metoda onClick musi 
być jeszcze zdefiniowa- 
na w pliku z Javą. Program 
powinien identyfikować 
brak definicji metody i pod- 
kreśli błąd. Można go łatwo 
naprawić, klikając na ikonę 
błędu i wybierając z rozwi- 
niętej listy pozycję Create 
'onClick(View)' in 'MainAc- 
tivity 


a activity main.xm 


MainActivity p mpatActivity ( 


e (Bundle dInstanceState) 


j Program przełączy 
się automatycznie do 
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generowana kolejna liczba. Jeśli wygenero- 
wanej liczby nie ma na liście, zostanie do 
niej dodana. 

4 Zapis tego algorytmu należy rozpocząć 
ała od deklaracji listy. Można to zrobić linijką: 
List<iInteger> lista = new ArrayList<>() ©- 
Tworzy to listę o nazwie lista, która może 
zawierać wartości typu Integer, czyli liczby 
całkowite. 


ew view) | 


List<InLege a = ArrayList<>() 


By List i ArrayList były w ogóle rozpo- 
Śa znawane przez program, należy dokonać 
importów - odpowiednio import java.util. 
List; i import java.util.ArrayList; 


android.os.Bundlc 


android.view.View 


java.util.ArrayList 


java.util.List 


4% Potem należy utworzyć generator liczb, 
czyli obiekt klasy Random, co można zro- 
bić, pisząc Random r = new Random(); 


ArrayLisL<>() 


By klasa ta była rozpoznawana przez pro- 
gram, należy jeszcze dokonać importu 
- import java.util.Random; 


java.util.ArrayList 


java.util.List 


java.util.Random 


IF Kolejny krok to użycie pętli, która będzie 
«9 powtarzała operację, dopóki na liście nie 
znajdzie się sześć elementów. Pętlą pozwa- 
lającą na takie określenie momentu zakoń- 
czenia jest pętla while. Tworząc ją, należy 
w nawiasie zapisać warunek, który musi być 
spełniony, aby pętla się wykonywała. Warun- 
kiem tym jest, by rozmiar listy był mniejszy 
niż sześć. Rozmiar możemy sprawdzić, korzy- 


stając z polecenia lista.size(). Pętla powinna 
być utworzona w formie: while (lista.size() 


<6) ) 


k(view view) i 


List<In > lista — ArrayList<> () 


Random Random () 


(lista.size() < €)[ 


4R Wewnątrz pętli trzeba zadeklarować 
U zmienną typu Integer (liczbę całkowitą). 
Wartość tej zmiennej powinna być genero- 
wana przez obiekt klasy Random. Ponieważ 
metoda nextlnt pozwala na określenie jedy- 
nie górnej granicy i generuje liczby od zera, 
trzeba skorzystać z pewnego zabiegu mate- 
matycznego. Potrzebna jest liczba od 1 do 49. 
Dlatego do liczby 1 należy dodać wygenero- 
waną liczbę mniejszą od 49 (wtedy mogą się 
generować liczby od O do 48). To spowoduje, 
że zmienna dostanie wartość z odpowiednie- 
go zakresu. Zatem należy zapisać: Integer 
nowe = 1 + r.nextlnt(49); 


ArrayList<> () 
Random () 
< 6) 


1 + r.nextInt ( 


sy Kolejny krok polega na sprawdzeniu, czy 
wygenerowana liczba znajduje się już na 
liście. Taką operację trzeba podzielić na kilka 
części i zrealizować skryptem, w którym: 
boolean czyjest = false; - jest dekla- 
racją zmiennej typu boolowskiego, mogącej 
przyjmować wartości prawda i fałsz, zmien- 
ną należy wykorzystać do przechowania in- 
formacji o tym, czy któraś z liczb na liście jest 
równa tej wygenerowanej, 
for (int i:lista) - tworzy pętlę for, któ- 
ra wykona się dla każdego elementu listy; 
w każdym kolejnym przejściu pętli zmien- 
na i będzie otrzymywać wartość kolejnych 
elementów listy, 
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T1 st lista = 


Tnteger> 


Random t = Random () 


(lista.size() < 6)[ 


— 1 + r.nextInt ( 
:lista) 


(i==nowe) ( 


) lista.add (nowe) 


if (i-=nowe)f - to instrukcja warunkowa 
porównująca element listy z wygenerowaną 
liczbą, 

czyjest = true; - gdy warunek jest speł- 
niony, zmienna czyjest dostanie wartość 
true, 

if (czyjest == false) lista.add(nowe); — 
po przejściu całej pętli for zmienna czyjest 
będzie miała wartość false, jeśli ani 
razu nie wystąpiła na liście nowa 
liczba, lub wartość true, gdy który- 
kolwiek z elementów listy miał taką 
wartość. Dlatego gdy ma ona wartość false, 
to poleceniem lista.add(nowe) należy dodać 
wygenerowaną liczbę do listy. 


(czyjest = ) lista.add(nowe) 
ł 
String napis = 
Następnie należałoby z wygenerowanej 
listy liczb ułożyć napis i wyświetlić go 
w oknie programu. Poleceniem String napis 
= "Wylosowano: „; © tworzymy zmienną 
napis, w której przechowywany będzie ciąg 
znaków, jaki wyświetli się użytkownikowi. 
Ciąg ten powinien zaczynać się od informa- 
cji, że są to wylosowane liczby, a dalej powin- 
ny być te liczby pokazane. 


te (savedlInstan ta 


actContentVicw (R.layout. 2 


przycisk = findViewBy 
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ate (Bundle savedInstance 


Dlatego w kolejnej linii trzeba skorzystać 
z pętlifor - w formie for (int i:lista) na- 
pis += i + ” ”; ©, co pozwoli odnieść się do 
każdego elementu listy i jego wartość dopisy- 
wać do zmiennej napis, rozdzielając kolejne 
liczby znakiem spacji. 


(czyjest = ) lista.add(nowe) 


zlista) napis 3 i t 


Dalej należałoby skonstruowany 
w ten sposób napis wyświetlić. Do 
tego celu można wykorzystać przycisk i za- 
stąpić na nim napis Generuj innym. Aby 
móc umieścić coś na przycisku, należy się 
do niego odnieść z poziomu skryptu. By było 
to możliwe, przycisk musi być polem klasy 
MainActivity. Trzeba zatem napisać: Button 
przycisk; © jako deklarację pola klasy. 


MainActivity AppCompatActivity (| 


© Button przycisk 


By w skrypcie klasa Button była 
rozpoznawana jako element aktyw- 
ności, trzeba dokonać importu - import 
android.widget.Button; 


java.util.ArrayList 
java.util.List 
java.util.Random 


android.widget .Button 


Do utworzonego pola klasy trzeba 

| przypisać przycisk znajdujący się 
w aktywności. To należy zrobić w meto- 
dzie onCreate, dopisując w niej: przycisk = 
findViewByld(R.id.button); © - gdzie sło- 
wo button jest id elementu z aktywności, 
jeśli nazwa przycisku nie była zmieniana 
w aktywności, a o tym mówi li- 
nijka android:id="©+id/button" 
w pliku XML. 


State) 


4% Na koniec metody onClick 
0) powinno znaleźć się po- 


adam1l3zajacigmail.com 


lecenie umieszczające napis na przycis- 
ku, czyli przycisk.setText(napis); 


Uruchomienie aplikacji 
Sprawdźmy, czy utworzone wcześniej wir- 
tualne urządzenie jest wybrane jako to, na 
którym będzie testowana aplikacja, ustawia 
się to w menu głównym ©. Następnie klika- 
my na Run, tuż obok. Aplikacja uruchomi 


app v || [5 Nexus One API22 A 


A 


My Application 


String napis = 
( i:lisLa) 


napis $= 1 t 


.setText (napis) 


się na wirtualnym urządzeniu na ekranie 
komputera. Kliknięcie na przycisk z napisem 
Generuj E£] powinno skutkować zmianą na- 


pisu na tym przycisku i pokazaniem zestawu 
wygenerowanych sześciu liczb 


BJĘLY QM 


A 


My Application 


WYLOSOWANO: 41 46 28 27 40 23 


Program na Androida: zapamiętaj 


kolejność 


olejnym projektem do wykonania w An- 

droid Studio będzie gra polegająca na 
zapamiętaniu kombinacji podświetlanych 
pól i powtórzeniu jej przez naciskanie od- 
powiednich przycisków. Jeśli są to uda, gracz 
wygrywa, jeśli nie - przegrywa. 


Budowanie wyglądu aplikacji 

W naszej grze znajdzie się pięć przycisków. 
Powinny one być rozmieszczone w oknie 
w taki sposób, by wypełniły całą jego szero- 
kość, a także całą wysokość. Jeśli przyciski 
będą ułożone w pionie, jeden pod drugim, 
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to wysokość każdego z przycisków powinna 
być taka sama. Tym razem wygląd aplikacji 
stworzymy w całości w trybie tekstowym, 
który w przypadku aplikacji na Andro- 
ida jest chętnie wykorzystywany przez 
programistów. 


mi Tworzymy nowy projekt w Android Stu- 
zla dio - tak jak w poprzedniej wskazówce 
wybieramy jako początkowy schemat Empty 
Activity ©. 


Empty Activity 


4% W otwartym pliku activity_main.xml 
Śa przełączamy się do trybu tekstowego. 


View ©, kasując zaznaczony tekst 


© Mainactivity.java X 


" encoding—"utf-8"?> 


|get.ConstraintLayout xmlns:andr| 


xmlns:app="r EL d 
xmlns:tools—"ht 


android: layout_height= 


LoolszcontexL=".Mai 


f . . . . 
f</androidx.constraintlayout .widget.ConstraintLayoutL> 
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Z jego poziomu usuwamy element Text- 


4% Następnie należy dodać do pliku znacz- 
©) niki, które spowodują utworzenie pięciu 


przycisków. Ponieważ przyciski będą różnić 
się tylko nieznacznie, można utworzyć jeden 
przycisk, a potem skopiować go i powielić, 
zmieniając tylko szczegóły, które mają róż- 
nić przyciski. Jednak by przyciski były ładnie, 
równomiernie ułożone w pionie, niezbędne 
będzie dodanie jeszcze jednego elementu 
- LinearLayout. 


/j Należy utworzyć znacznik LinearLayout 
"EE wraz z jego zamknięciem, czyli: <Line- 
arLayout> </LinearLayout> 


IF W znaczniku otwie- 
«w rającym należy teraz 
dodać właściwości tego 
elementu okna. Powi- 
nien on swoim rozmia- 
rem wypełnić ekran. 
Dlatego należy dopisać 
android:layout_heigh- 
="”match_parent" [], 
by wysokość elemen- 
tu wypełniła ekran, 
i android:layout_wid- 
th="match_parent" [], 
aby wypełnić szerokość. 


k/ ito" 


RW tym samym 
9 znaczniku musimy 
zapisać, aby elementy 
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okna, które będą umieszczane wewnątrz 
tego znacznika (czyli przyciski), były ukła- 
dane jeden pod drugim. Trzeba dodać linijkę: 
android:orientation="vertical" 


<LinearLayout 


audzoid:layvut width=" 


andr 


id:layout height 


androidzorientaLion=" 


Teraz przyszedł czas na dodanie przyci- 

sków. Ponieważ będą podobne, powieli- 
my jeden tak, by stworzyć ich pięć. Dodaje- 
my znacznik Button © między znacznikami 
LinearLayout. 


<LincarLayout 


yont_widt:h=' 


orientation=" 


<Dutton/> 


W znaczniku Button trzeba ustawić id 

przycisku - każdy z nich będzie miał 
inne. Pierwszy będzie miał id button1, co 
zapisujemy android:id="©+id/button1" 


<Button 


android:id 


Dopisujemy także: android:layout_wid- 
th="match_parent"” ©, by szerokość 
przycisku wypełniła cały wolny obszar. 


źButton 


android:id="f+id/butt 


android: layout width= 


1 By przyciski podzieliły się po równo 

wysokością ekranu, trzeba w nich 
ustawić właściwości android:layout_he- 
ight="wrap_content" i android:layout_ 
weight="1" © (co ustawia „wagę” przycisku 
- jeśli mają one taką samą „wagę”, po równo 
dzielą się wysokością). 


<BuL Lou 


android:id="G+iqd 


android:layout_ width 


android:layout_ height= 


:layout weight= 


<Button 


android 


1 Można też ustawić tekst na przyci- 
skach - tak by go nie było, polece- 


niem android:text=" ” 

1 Dodajemy linijkę android:onClick= 
"onClickP1" 6, co sprawi, że do na- 

ciśnięcia przycisku przypisana zostanie meto- 

da onClickP1, którą trzeba będzie zdefiniować 

w MainActivity.java (patrz kolejna strona). 


<Button 
andr 
andr ut_ width 
andr >ut_height—" 
andr 


androld:text=" " 


androi >nClick 


1 Tak stworzony przycisk można po- 

wielić - zmieniając id (button2, 
button3 itd.) i nazwę metody, która ma być 
wywoływana po naciśnięciu przycisku - 
onClickP2 ©, onClickP3 itd. 


<?xml version-"1.0" 


<androidx.constraintlayout .widget - 


layout _width- 
out_heiqht 


rientation= 


ut._heigh 


we i ght. 


ayout_height 


|. weight="1" 
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4 / Zmiany wprowadzane ty_main.xml (c) MainActivity.java > 
LS "w pliku XML powin- com. example .graż 
ny być na bieżąco widoczne na 
podglądzie obok. Po powieleniu 
przycisku podgląd powinien po- 
kazywać pięć © takich samych 
przycisków ułożonych jeden pod MainActivity AppCompatAcLivity ( 
drugim. 


androidx.appcompat:. app. AppCompatActivity 


android.os.Bundle 


dInstanccStatc) [ 


Dalsze prace będziemy prowadzić 
już w pliku MainActivity.java 


w Z PDOZIOMIU SATYPCU 
By z poziomu skryptu móc odnosić się A TZEWIZNACYA 

ido przycisków, powinny one być zade- RPNE RJ NGK 
klarowane jako pola klasy. Taką deklarację 
możemy napisać w jednej linii kodu. Jeśli 
deklarujemy kilka elementów tego samego 
typu, można wypisywać je po przecinku. 
Piszemy zatem: Button p1,p2,p3,p4,p5; 


4% Do zadeklarowanych pól klasy trzeba 
«8 teraz przypisać odpowiednie przycis- 
ki - w metodzie onCreate należy napisać 
p1 = findViewByld(R.id.button1); 
przycisk o id button1 z poziomu skryptu był 
przechowywany pod nazwą pt. 


nce3 


4% Jednak by klasa Button była rozpo- 
a znana przez skrypt, trzeba dokonać 
jej importu, pisząc: import android. 
widget.Button; 
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onCrcate (Bundle 


.onCreate (savedTnatanceState) 


ContLentYiew (R.layu 


Analogicznie trzeba postąpić z pozosta- 
' tymi przyciskami 


Przyciski będą w wygenerowanmej przez pro- 
gram kolejności zmieniać kolor. Należy na- 
pisać skrypt, który pozwoli na generowanie 
tej kolejności. 


| W tym celu przyda się tablica, która 

będzie miała 10 pozycji. Każda kolejna 
pozycja będzie mogła przyjąć wartość od 1 
do 5, co będzie odpowiadało numerom przy- 
cisków od pl do p5. Tablica powinna być 
zadeklarowana jako pole klasy. Aby stworzyć 
taką tablicę, trzeba napisać int[] kolejka = 
new int[10]; 


Button pl,p2,p3,pi,p5 
U] kelsika = 


£% Następnie trzeba będzie wypełnić tabli- 
a cę wartościami. Dobrze sprawdzi się tu 
pętla for, zatem w metodzie onCreate należy 
napisać kał ba i=0;i<10; adi ] 


0] 


findViewDyId(R.id.buttonS5) 


i=0 i<10 CEF) 


Pętla ta powinna pod kolejnymi indek- 
sami tablicy umieszczać wygenerowane 
liczby. Żeby móc je generować, potrzebny 
jest obiekt klasy Random 


Button pl,p2 


Random r 


Random () 


savcdInstanccStatc) 


By klasa była rozpoznana przez 
' program, należy dodać ją do pro- 
jektu, pisząc import java.util.Ran- 
dom; 


android.os.Bundle 


android.widget .Button 


java.util.Random 


= Teraz, korzystając z obiektu klasy Ran- 

9 dom, wewnątrz pętli for można wpi- 
sywać kolejne wygenerowane wartości 
z metody nextlnt. Użycie tej metody z para- 
metrem 5 spowoduje wygenerowanie takiej 
wartości, w której minimalna możliwa liczba 
to 0, a maksymalna to 4. By do tablicy trafiły 
liczby od 1 do 5, trzeba do tej wygenerowa- 
nej dodać jeden. Piszemy zatem: kolejkali] 
=1 + rnextlnt(5); 


i=0;i<10;i++) I 


kolejka[i] =1+ 


.„nextInt (5) 


| By móc ŚWiiczne „podświetlać” przy- 

ciski według wygenerowanej wcześniej 
kolejności, należy zapisać kolory, jakie mają 
mieć przyciski. Jeden kolor to kolor „pod- 
świetlonego” przycisku, czyli aktywnego, 
a drugi - nieaktywnego. Tymi kolorami bę- 
dziemy posługiwać się w kilku miejscach 
w kodzie, najlepiej zatem zapisać je jako pola 
klasy, co ułatwi w przyszłości zmianę koloru. 
Gdy programujemy na Androida, kolory zapi- 
sujemy jako liczby całkowite. Aby uzyskać od- 
powiednią liczbę, potrzebna będzie metoda 
klasy Color z biblioteki android.graphics. 
Color; © - trzeba więc ją importować. 


android.widget .Button 


android.graphics.Color 


% Następnie należy utworzyć dwa pola 
Gz typu int - jedno o nazwie aktywny 
a drugie nieaktywny 


Button pl 
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Nowym polom nadaje się wartości, korzy- 

stając z metody Color.parseColor() ©, 
gdzie w parametrze podaje się heksadecymal- 
ny zapis koloru w systemie RGB. 


new CountDownTimer( n 
ARARAT AZ 


).start(); 


RGB 


To jeden z modeli przestrzeni barw, 
którą opisuje się współrzędnymi R, G 
i B. Nazwa ta powstała z połączenia 
pierwszych liter angielskich nazw barw: 
R - red (czerwonej), G - green (zielonej) 
i B — blue (niebieskiej), z których model 
ten się składa. Jest to model wynikający 
z właściwości ludzkiego oka — wrażenie 
widzenia dowolnej barwy można wywołać 
przez zmieszanie w ustalonych propor- 
cjach trzech wiązek światła o barwie 
czerwonej, zielonej i niebieskiej. Jest 
to model często stosowany do zapisu 
kolorów w informatyce. Ma to związek 
z budową urządzeń wyświetlających. 
Wartość każdej z trzech składowych 
barwy zapisuje się liczbą 

z zakresu 0-255. Gdy każda 

znich ma wartość zero, można 
powiedzieć, że „nie ma żadnej 

wiązki światła, w żadnym 

z kolorów” — w ten sposób 

uzyskuje się barwę czarną. 

Gdy wszystkie trzy składowe 

mają maksymalną wartość 

255, wychodzi barwa biała. 

Do zapisu koloru stosuje się 

często notację heksadecymal- 

ną (szesnastkową), system 
heksadecymalny - pozycyjny 

system liczbowy, w którym 

podstawą jest liczba 16. Do 
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Zmiana koloru 
przycisków 

Zmiana koloru przycisków po- 
winna odbywać się w sposób 
cykliczny. By wykonywać coś 
cyklicznie, w metodzie onCreate można 
utworzyć obiekt CountDownTimer ©. Jednak 
by było to możliwe, trzeba dokonać odpo- 
wiedniego importu 


zapisu liczb w tym systemie potrzebne jest 
szesnaście znaków (cyfr szesnastkowych). 
System heksadecymalny to pozycyjny 
system liczbowy, w którym podstawą jest 
liczba 16. Do zapisu liczb w tym systemie 
potrzebne jest szesnaście znaków - cyfr. 
Poza tradycyjnie używanymi cyframi 
z systemu dziesiątkowego - od O do 9, 
wykorzystuje się też znaki A, B, C, D,EiF. 
By w wygodny sposób móc dobierać kolo- 
ry do programu, można w wyszukiwarce 
internetowej Google wyszukać frazę rśgb 
color picker . Wyszukiwarka powinna 
wtedy wyświetlić wygodne narzędzie do 
wyboru barwy, dla której uzyskamy zapis 
RGB - także ten heksadecymalny . 
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import java.util.Random; 


import android.os.CountDownTimer; 


Random r = new Random() ; 


int numer = 0; 


Tworząc go, podaje się dwie liczby. 

Pierwsza z nich to całkowity czas do 
odliczenia, druga - to cykliczny odstęp po- 
między kolejnymi odliczeniami. I tak oto 
możemy wykonać coś zarówno po upływie 
całkowitego czasu określonego dla obiektu, 
jak i cyklicznie, co pewien określony czas. 


To, co ma się wykonać, definiujemy 

w dwóch metodach nowego obiektu - 
odpowiednio onFinish © (po upływie całego 
czasu) i onTick © (cyklicznie). 


new CountDownTimer( m 


public void onTick(long millisUntilFinished) 


void onFinish() [I 


Ogólny schemat cyklicznego działania 
to ustawienie wszystkich przycisków na 
kolor nieaktywny, a następnie zmiana kolo- 
ru jednego z przycisków na kolor aktywny. 


publ void onTick(long millisUntil 


pl.setBackgroundColor (n 


W kolorze aktywnym przyciski powinny znaj- 
dować się według wygenerowanej wcześniej 
kolejności. Pierwszym krokiem w metodzie 
onTick powinna być jednak zmiana koloru 
przycisków na nieaktywny - co dla pierwsze- 
go przycisku będzie miało formę polecenia: 
p1.setBackgroundColor(nieaktywny); 


Metodę setBackgroundColor trzeba wy- 
wołać też dla pozostałych 
czterech przycisków 


Następnie w głównej klasie 
należy zadeklarować pole 
o nazwie numer, które będzie 
przechowywało numer aktual- 


nie aktywnego przycisku. Pole to powinno 
mieć wartość początkową 0 ©, gdyż sko- 
rzystamy z niego jako indeksu do tablicy 
przechowującej kolejność aktywnych przy- 
cisków, a one w tablicy kolejka są numero- 
wane, począwszy od elementu o indeksie 0. 
Dodatkowo wartości tego pola będziemy 
mogli użyć do wskazania, który z kolei przy- 
cisk jest już aktywny. Z każdym kolejnym 
wywołaniem metody onTick wartość tego 
pola będzie rosła. 


W metodzie 0n- 

Tick powinno 
znaleźć się sprawdza- 
nie, czy dany przy- 
cisk jest tym, który 
znajduje się w tabli- 
cy z kolejnością pod 
indeksem odpowia- 
dającym aktualnej 
wartości pola numer. 
Przyciskowi, na który 
wskazuje kolejność, należy zmienić kolor na 
aktywny i napis - tak, aby wskazywał, który 
z kolei przycisk jest wyświetlony jako aktyw- 
ny. Dla sprawdzenia, czy pierwszy przycisk 
(p2) jest tym, na który wskazuje ko- 
lejność - trzeba napisać instrukcję 
warunkową w formie: if (kolejka- 
[numer] == 1)( ) 


3.setBackgroundColor (nieaktywny) ; 
'4.setBackgroundColor (nieaktywny) ; 


.setBackgroundColor (nieaktywny) ; 


(kolejka[numer] = 1) I |) 


public void onTick(long millisUntilFinished) 
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zg Gdy ten warunek będzie spełniony, trze- 

ba dla przycisku pl zmienić kolor tła na 
aktywny, co robi się poleceniem p1.set- 
BackgroundColor(aktywny); 


Należy też zmienić napis na przycisku. 

I tu można posiłkować się wartością pola 
numer, jednak pole to uwzględnia kolejność 
przycisków od zera, użytkownik zaś wca- 
le nie powinien wiedzieć o numerowaniu 
przycisków od zera - dla niego pierwszy 
aktywny przycisk powinien być oznaczony 
numerem 1. Dlatego na przycisku powinna 
się znaleźć wartość numer+1. Ponieważ jest 
to wartość liczbowa - nie można jej bezpo- 
średnio umieścić na przycisku, trzeba ją prze- 
robić na tekst, co można uzyskać, korzystając 
z polecenia String.valueOf(). Całość powinna 


r (aktywny) 
pl.seLTexL(SLring.v eOf (numer+1) ) 
(kolejk umer] = 2 


.sctBackgroundC ktywny) 


p2.setText (String.valueOf(numer+1) ) 


numer] 7 3) l 
„.setbackgroundlolor (aktywny) 


.SELTexL (SLrinq.valucOf (numer+1) 


kolejka[numer] —= 4) I 
.sctBackgroun r (aktywny) 

.setText (Stri 
jka[numer] == 
etbackgroundc r (aktywny) 


.seLTexL(SLring. Of(uumer+t1) ) 
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mieć zatem formę: pi.setText(String.valu- 
eOf(numer+1)); 


)lejka[numer] = 1) | 


1.setBackgroundColor (aktywny) 


1.setText (String.valueOf(numer+1) ) 


Analogiczne instrukcje warunkowe 
należy zbudować też dla pozostałych 
czterech przycisków. 


By pole numer z każdym kolejnym 
zdłz © wywołaniem metody onTick wskazy- 
wało na kolejny przycisk, należy zwiększać 
jego wartość o jeden, co można uzyskać po- 
leceniem numer += 1; 


p4.setText(String.valueOf(numer+l)) 


(kolejka[numcr] — 5) [ 
p>-. setRackgronndCo lor (aktywny) 


p5.sEeLTexL (SLrinyg.valueOf(numer+1) ) 


numer t= 1 


Na koniec opisywanej metody powin- 

no się jeszcze „wyzerować” wartość 
pola numer, gdy osiągnie już wartość 10. 
W tym celu trzeba stworzyć instrukcję 
warunkową, która sprawdzi, czy numer 
ma wartość równą 10. Powinno to wyglą- 
dać następująco: if (numer==10) £ ) 


PO>-.SELIEXL|SLILNJ.vaiul 


numer += 1 


(numer == 10)f 


f Gdy opisany warunek będzie 
śm spełniony, trzeba nadać polu 
numer wartość 0, co osiągniemy, pisząc 
numer = (0; 
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Trzeba określić jeszcze treść metody on- 
Finish, która wykonuje się po odlicze- 
niu czasu określonego przez obiekt klasy 
CountDownTimer. 


4 By użytkownik wiedział, że może już 
uke zacząć klikać na przyciski w wygenero- 
wanej przez program kolejności, można na 
każdym z przycisków umieścić napis klikaj. 
Dla pierwszego z przycisków (pd) można to 
zrobić poleceniem pi.setText(klikaj”); 


)-start () 


Analogicznie trzeba napisać to samo dla 
pozostałych czterech przycisków 


]-start () 


4% Podobnie trzeba zrobić z kolorem przy- 
«5 cisków - wszystkie przyciski powinny 
otrzymać nieaktywny kolor, co dla pierwsze- 
go przycisku można osiągnąć, pisząc pi.set- 
BackgroundColor(nieaktywny); ©. 


p2.actTcxt ( 
3.actTcxt ( 
D4.SELTEAxL ( 


.SEtText ( 


„setbackgroundtolor (nieaktywny) 


MainActivity 


p3,p1,p5 


ApptompatActivity ( 


J Analogicznie trzeba postąpić dla pozo- 
W stałych czterech przycisków 


f By zapisywać kolejność kliknięć wykona- 
udlz nych przez gracza, należy utworzyć pole 
klasy, będące tablicą liczb całkowitych (typ 
int). Do niego z każdym kliknięciem na przy- 
ciski będą trafiać numery odpowiadające tym 
przyciskom pod indeksami odpowiadającymi 
kolejnym kliknięciom w taki sposób, by osta- 
tecznie obydwie tablice - ta z wygenerowaną 
kolejnością i ta z kolejnością kliknięć gracza 
- gdy gracz poprawnie odtworzy kolejność 
miały takie same wartości pod tymi samy- 
mi indeksami. Zatem, by utworzyć tablicę 
do przechowywania numerów odpowia- 
dających numerom, na które gracz kliknął, 
piszemy int[] wyklikane = new int[10]; 


LI kolejka = 
[10] 


l] wyklikane = 


Random r = 


Random () 


fp Kiedy deklarujemy pola, należałoby 
i jeszcze utworzyć jedno pole klasy typu 
boolowskiego, które będzie przechowy- 
wało informację o tym, czy gra już się roz- 
poczęła. A nie rozpocznie się ona, dopóki 
nie zakończy się sekwencja wyświetlania 
aktywnych przycisków i nie wykona się 
metoda onFinish z obiektu odliczającego 
czas. Dzięki zastosowaniu tego pola będzie 
można „zablokować” możliwość klikania 
na przyciski, gdy cała sekwencja nie 
zostanie odtworzona. Pole to może 
mieć nazwę czyGra - a jego dekla- 
racja może mieć postać boolean 


z czyGra = false; 9. 
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Następnie należy zadeklarować metody 

odpowiedzialne za kliknięcia na przy- 
ciski. Mają już one określone swoje nazwy 
z pliku XML. Dla pierwszego z przycisków 
jest to onClickP1 - co deklaruje się, pisząc 
public void onClickP1(View view) ( ) e- 
By parametr klasy View, który jest wymagany 
dla metod wykonywanych przy kliknięciu 
na przycisk, był rozpoznany przez program, 
należy dokonać odpowiedniego importu ©- 
Wszystkie metody odpowiedzialne za kliknię- 
cia na poszczególne przyciski będą bardzo 
podobne - różnicą będzie to, że każda odnosi 
się do innego przycisku. Dlatego najpierw 
można zdefiniować jedną z nich, a potem ją 
powielić. 


android.os.Bundle 


android.view.View 


27. 


By „zablokować” możliwość klika- 

nia na przyciski, zanim cała ich se- 
kwencja będzie oznaczona jako aktywna, 
należy skorzystać z pola czyGra w taki 
sposób, by wszystko, co ma się wyko- 
nywać w tej metodzie, było zamknięte 
w instrukcji warunkowej, która pozwoli 
wykonywać polecenia, gdy czyGra dosta- 
nie wartość true. Wystarczy do tego zapis 
if (czyGra) ( ) €. Umieszczenie w warunku 
samej nazwy zmiennej typu boolowskiego 
sprawia, że warunek jest spełniony, gdy ma 
ona wartość true, a niespełniony - gdy false. 


Wartość początkowa pola czyGra to false. 
W żadnym miejscu skryptu nie zapisano 
do tej pory, by pole to miało inną wartość. 
Dlatego trzeba gdzieś nadać mu wartość true, 
by instrukcje z metod odpowiedzialnych za 
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klikanie na przyciski mogły się wykonać. Naj- 
lepszym miejscem na nadanie tej wartości 
polu czyGra © jest metoda onFinish obiektu 
klasy CountDownTimer. 


Gdy gracz kliknie na przycisk, a gra już 

trwa, na przycisku powinien pojawić się 
numer kliknięcia wykonanego przez gracza. 
Można ten efekt uzyskać, pisząc wewnątrz 
instrukcji warunkowej pi.setText(String. 
valueOf(numer+1)); ©. Polecenie to zmienia 
napis na przycisku na wartość pola numer 
powiększoną o jeden. Podobnie jak wcześ- 
niej tu także stosujemy polecenie String. 
valueOf(), by wartość liczbową przerobić na 
tekst, bo tylko teksty można umieszczać na 
przycisku. 


Liczba odpowiadająca przyciskowi, na 

który kliknięto, powinna trafić do tablicy 
wyklikane pod indeksem odpowiadającym 
kliknięciu, a indeks wyznacza pole numer. 
Operację tę można zrealizować, pisząc wy- 
klikane[numer] = 1; € w przypadku pierw- 
szego przycisku. W kolejnych metodach do 
tablicy będą trafiały inne liczby odpowiada- 
jące liczbom w nazwie metody. 


Dalej należy zwiększyć wartość pola 
numer o jeden, by kolejne kliknięcie na 
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view) i 


kPl(view 


przycisk (ten lub inny) skutkowało wyświet- 
leniem na nim następnej liczby. Ten krok re- 
alizujemy, pisząc numer+=1; ©- 


To jeszcze nie jest koniec definicji metody. 
Jeszcze jej nie powielajmy, ponieważ trzeba 
do niej dodać sprawdzanie poprawności ko- 
lejności wyklikanej przez gracza. 


fg Do sprawdzenia poprawności kolejności 

kliknięć wykonanych przez gracza moż- 
na wykorzystać dodatkową metodę. Metoda 
może mieć typ boolean i zwraca wartość 
true lub false - zależnie od wyniku. By me- 
toda mogła zwracać wartość, podczas jej 
deklaracji należy słowo void zastąpić typem 
danych, jaki ma zwrócić - w tym wypadku 
będzie to boolean. Deklaracja metody po- 
winna mieć więc postać: private boolean 


spr(X | 


Działanie metody sprawdzającej powin- 
no polegać na porównywaniu kolejnych 
elementów tablicy kolejnosc i wyklikane. By 
odnosić się do kolejnych elementów tablic 
poprzez indeksy, należy wykorzystać pętlę 
for 


9 Wewnątrz tej pętli należy poprzez in- 

) strukcję warunkową porównywać ele- 
menty tablic o tym samym indeksie - if(wy- 
klikanef[i]!=kolejkali]) ( ) ©. != sprawdza, 


02408 


10;i++) ( 


lejka[i])( | 


wyklikane[i] I= k 


czy wartości są różne. Jeśli są różne - waru- 
nek jest spełniony. 


Gdy warunek jest spełniony i wartości są 
różne, to znaczy, że kolejność jest niepo- 
prawna. Dlatego należy wykonać polecenie 
return false; ©. Przerywa to dalsze wyko- 
nywanie metody. 


JF" Jeśli pętla się zakończy, to znaczy, że ni- 
9 gdy nie przerwano jej działania, czyli ni- 
gdy elementy tablic nie były różne. A to ozna- 
cza, że gracz poprawnie odtworzył kolejność. 
Zatem można użyć polecenia return true; 


R W ten sposób wywołanie metody spr() 

9 będzie niosło za sobą wartość mówiącą 
o poprawności zadania wykonanego przez 
gracza. Z metody tej należy skorzystać w me- 
todach wykonywanych po kliknięciu przy- 
cisków. Jeżeli pole numer dojdzie do warto- 
ści 10, należy sprawdzić, co zwraca metoda 
spr(). Można to zrobić jedną instrukcją wa- 
tunkową - if(fnumer==10 8.8 spr()) ( ) ©; 
gdzie mamy dwa warunki połączone spójni- 


pl.setText (Strinq.valueoOf(numert1) ) 


wyklikane [numer] = 1 


numer+=1 


(numer==10 ££ spr()) [ 
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Java na Androida 


kiem i - czyli obydwa muszą być IBIRRFPEEDESESTNESIEZEEYPPPIE 
spełnione. Ten zapis sprawia, że | BĘZA EUESE 
pole numer musi mieć wartość 
10 oraz spr() musi zwracać true. Należy również odpowiednio zareago- 
wać, gdy kolejność wytypowana przez 
Gdy warunki są spełnione, można poin- gracza nie będzie prawidłowa. Do stworzo- 
formować gracza o wygranej - na przy- nej instrukcji warunkowej trzeba dopisać 
cisku może pojawić się napis Wygrywasz, co sekcję else if, gdzie warunkiem będzie to, 
można uzyskać, pisząc pL.setText(„WYGRY- że pole numer ma wartość 10 i jednocześnie 
WASZ”); ©. metoda spr() zwraca false. Zapisać to można 
SRERSZE(SEYIAGAĆÓ tak: else if (numer==10 68 !spr()) 
Analogicznie do wygranej - należy 
poinformować gracza o przegranej, 


s aclivity_main.xml [C) MainAclivity.java * 


122 1 [ 


sr=10 «%« spr()) fp2.setrext (FWYGRZWASZ"”) ;] 


(numcer"—10 «« fspz(j) [p2.sctText (FEZZS9ZYWAZE") ; ] 


onClickP3(View view) i B 
1 


„setText (String.valueOf (nu 
[1 ])=3; 


==10 ££ spr()) | .setT 


(numer==10 «« ASDBEQJ) (p3.setrext (FERZESZYNASZ”) : 1 


onClickP4(Vicw view) (| € 
A 
4.seLTextL (SLring.valueoOf ( 


46 spr()) ( „setText (FWZORZWADSZ”) ) 


r==10 «« fspz(j) (p4-setText ("Bzzegzywazz) : ) 


onClickP5(view view) ( D 
l 
- set.-Text (String .va lueOf (nun +1)): 


klikane [numer] = 5 


er=10 «« spr()) (p5.setText (FMZGBYMAZA") ; ) 


E1==10 66 fispz())) (p5.setText (FEzzegzywazz”) ;] 
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[©], które będą odnosić 
się w swojej treści odpo- 
wiednio do przycisków 
0 66 spr()) (pl.setText( p2, PZ, p4ip5. 
==10 ££ !spr()) (pl .setText.( 

Uruchamiamy program. 
Przyciski w jego oknie 
- co można zrobić poleceniem pi.setTe- | będą w wygenerowanej kolejności zmieniać 
xt(„Przegrywasz”); ©. kolor . Gdy sekwencja się zakończy, na każ- 


W ten sposób kończy się definicja me- | | by gracz rozpoczął wybieranie swojej se- 
/ tody onClickP1 - taką definicję moż- | | kwencji. Gdy gracz kliknie po raz dziesiąty, 
na powielić, by powstały metody onClickP2 | | na ostatnio wybranym przycisku pojawi się 
EJ, onClickP3 [E], onClickP4 [Hi onClickPS | | informacja o wygranej lub przegranej ©. 


PRZEGRYWASZ 


© Build APK(s) 
APK(S) generated successfully for 1 module: 
(4 Module 'app': locate or analyze the APK. 


38J0|ĆXJ 3/1 


ETNO 
26 chars 145:44 CRLF $ UTF-8 $ 4spacesż "u 


ih 


Build] YJ Build Bun. : heto [ni 
dle(s) / APK(SITTAGUBuild AKP(SJf 1 


Run lIools VC$ Window Help Uikan jlocate ( Uesci komunikat 


9, Make Project Ctr+F9" gainActivity 
Make 
Edit Build Types. == |UENISNINANĄ PSZ kz PT ira 
Edit Flavors Ę 


Edit Libraries and Dependencies. 


Select Build Variant 


Generate Signed Bundle / APK... Build Bundle(s) JAVA ZACZNIJ PROGRAMOWAĆ 89 
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Java: 


podsumowanie 


Poznaliśmy już wiele przydatnych poleceń i instrukcji z języka 
Java. Instrukcje te można układać w algorytmy pozwalające 
na rozwiązanie skomplikowanych zagadnień. Część z nich 

z pewnością można wykorzystać także w innych projektach. 
Wiele jest algorytmów uniwersalnych, które można stosować 


wielokrotnie 


Metoda umieszczająca losowe 
wartości liczbowe w tablicy 


W zaprezentowanym skrypcie: 


[EJ - jest deklaracją tablicy, w której będą 
przechowywane liczby całkowite. 

HB - jest deklaracją metody dajlosowe. 

[H - tworzy w metodzie obiekt klasy Random. 
Trzeba pamiętać, by umieszczać w pro- 
jekcie import java.util. Random; ©, 
aby klasa ta mogła być rozpoznana przez 
program. 

7 


0 [-] import java.util.Random; 


[J - to pętla for, która pozwoli wykonać coś 
10 razy. 
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[Jint[] zestaw = new int[10]; 


[jprivate void dajlosowe () i 

|| Random r = new Random() ; 

E for (int i = 0;i<10;i++)f 
[Ą zestaw[i] = r.nextInt(10); 
ł 

Li 


IB - wpisuje do tablicy pod indeksem odpo- 
wiadającym aktualnej wartości zmien- 
nej i (która rośnie z każdym przejściem 
pętli o 1) wygenerowanej wartości od 
0 do 9 (10 jako granica nie może być 
wygenerowane). 
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GENEROWANIE WARTOŚCI PSEUDOLOSOWYCH 


W zaprezentowanym przykładzie dla obiektu 

klasy Random wywoływana jest metoda 

nextlnt. Pozwala na wygenerowanie liczby 
METODA 
nextBoolean() 


CO DAJE 


całkowitej. Jednak nie tylko liczby całkowite 
może generować taki obiekt. Metod tych jest 
znacznie więcej, a niektóre z nich to: 


Zwraca wartość true lub false. 


Zwracają wartość z zakresu 0.0-1.0. Wyniki dawane przez te dwie metody 


nextDouble() 
i nextFloat() 


różnią się jednak dokładnością (precyzją). Wynik w typie double oznacza 
możliwość przechowania go na większej liczbie bitów, zatem ułamek ten może 


mieć większą precyzję (co sprowadza się do większej liczby cyfr po przecinku). 


Metody nextlnt można użyć także bez uzupełniania jej parametru 


nextlnt() 


mówiącego o granicy. Wygeneruje się wtedy liczba mieszcząca się w całym 


zakresie typu danych Integer. 


Metoda wyznaczająca najmniejszą 


liczbę z tablicy 


I nnym przydatnym algorytmem jest wyzna- 
czanie minimalnej wartości z tablicy. 


W tym celu można zadeklarować metodę 

dajnajmniejsza. By wywołanie metody 
niosło za sobą zwracaną wartość, metoda 
powinna mieć typ inny niż void. Załóżmy, 
że metoda odnosić się będzie do tablicy wy- 
pełnionej liczbami całkowitymi (może to 
być tablica z poprzedniej porady). Napiszmy 
zatem private int dajnajmniejsza()£ ) ©. 


private int dajnajmniejsza() ( 


L 


Najmniejsza wartość z tablicy będzie 
przez metodę przechowywana w zmien- 
nej. Utwórzmy zmienną o nazwie minimum 
tego samego typu co cała metoda. Jako war- 
tość początkową należy dać jej pierwszy 
element tablicy, z której najmniejszą wartość 


ma wyznaczać metoda. Napiszmy zatem int 


minimum = zestaw[0]; ©- 
private int dajnajmniejsza() ( 
int minimum = zestaw[0]1; 


L 


Dalej należy poprzez pętlę odnosić się 

do kolejnych elementów tablicy. Dlatego 
tworzymy pętlę for ©, która będzie zwiększa- 
ła wartość wewnętrznej zmiennej o 1, po- 
cząwszy od zera aż do 10, bo tyle elementów 
ma tablica. 


private int dajnajmniejsza() ( 
int minimum — zestaw[0]; 
tor(int i=0;i<10;i++) ( 


, 
Ł 


Wewnątrz pętli for należy umieścić 
instrukcję warunkową. Powinna ona 
w swoim warunku sprawdzać, czy zmienna 


JAVA ZACZNIJ PROGRAMOWAĆ 


91 


adam1l3zajacigmail.com 


Java: podsumowanie 


minimum ma wartość większą niż element ta- 
blicy, do którego można odnieść się poprzez 
indeks odpowiadający zmiennej wewnętrz- 
nej z pętli for. Powinno to być zapisane jako 
if (minimum > zestawli]) ( ) ©- 


private int dajnajmniejsza () ( 
int minimum = zestaw[0]; 
for(int i=0;i<10;i++) ( 
if (minimum>zestaw[i]) ( 


ł 


1. 


Kiedy opisany warunek będzie prawdą, 
należy nadać zmiennej minimum nową 
wartość, która powinna być równa zesta- 
wl[i] ©, czyli elementowi tablicy, który był 


private int dajnajmniejsza () 
int minimum = zestaw[0]; 
for(int i=0;i<10;i++) (I 
if (minimum>zestaw[i])( 


minimum = zestaw[i]; 


ł 


mniejszy (lub równy) wcześniejszej wartości 
zmiennej minimum. 


Kiedy pętla for zakończy swoje działanie, 

to znaczy, że sprawdzone zostały wszystkie 
elementy tablicy, a zmienna minimum jest rów- 
na temu najmniejszemu. Można napisać return 
minimum; ©, co sprawi, że wartość zmiennej 
minimum będzie zawsze zwracana jako wat- 
tość wywołania metody. Przedstawiony algo- 


private int dajnajmniejsza () 
int minimum = zestaw[0]; 
for(int i=0;i<10;i++)4 
if (minimum>zestaw[i])f( 
minimum = zestaw[i]; 


ł 
return minimum; 


ł 


rytm wyznaczania najmniejszej liczby z zesta- 
wu jest uniwersalny. Mając tablicę z liczbami 
w innym typie danych (na przykład double czy 
float), wystarczy zadeklarować zmienną mini- 
mum i samą metodę - jako ten sam typ danych 
- a działanie algorytmu pozostaje niezmienne. 


Metoda wyznaczająca największą 


liczbę z tablicy 


N a tej samej zasadzie co w poprzednim 
przykładzie można napisać metodę 
zwracającą największą liczbę z tablicy. Wte- 
dy wewnątrz metody należy zadeklarować 
zmienną maksimum 6. Przechodząc po 
kolejnych elementach tablicy, trzeba spraw- 
dzać, czy są one większe od aktualnej warto- 
ści zmiennej maksimum. Jeśli jakiś element 
tablicy ma wartość większą od tej zmiennej, 
zmienna ta powinna dostać nową wartość 
równą temu elementowi. Tak jak w wypad- 
ku najmniejszej z liczb po przejściu całej pętli 
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private int dajnajwi 


int maksimum = zestaw[0]: 
for(int i=0;i<10;i++)( 
if (maksimum<zestaw([i])£ 
maksimum = zestaw[i]; 


ł 
return maksimum; 


ł 


zwrócona (return maksimum; 
nik działania metody. 
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PALETA KONTROLEK 


Budując programy z oknem 
graficznym, możemy korzystać 
z palety kontrolek. Znajduje się 
tam wiele ciekawych kontrolek, 


Source 


Design 


StartPage X [EJ] PanelGryjava X |(aQp NewiFramejava X 


story | ESĘB [9| EH » 8 


gy To select mulupie components in an area hold Shiftand draa mouse over the componen 


które mogą być przydatne 
w różnego rodzaju aplikacjach. 
Na przykład Check Box [l 


Jirec 


colors 


wykorzystuje się do tworzenia 


Sportw 


list wielokrotnego wyboru, pole food 


tego typu może być zaznaczone 

lub nie. Często można zobaczyć 

Check Boxy przy akceptacji regulaminów itp. 
Innym ciekawym elementem jest Combo 
Box [£], czyli rozwijana lista elementów do 
wyboru. 


Palet.. x 
—| Swing Containers 
Panel 


Tabbed Pane J[ Split Pane 


Suoll Pane LE. Toel Bar £ Desktop Pane 


[| mternal Frame [%| layered Pane 
—| Swing Controls 


ubai Label (22) Button 


A5- check Box E - 


B =) Comho Box 


eu) Toggle Button 
Radio Button %— Button Group 
EJ List Text Field 


Text Area GEL Scroll Bar C © siider 


[D <7 Proaress Bar (1-') Formatted Field [=] Password Field 


LIż) Spinner Separator I | Text Pane 


[2] Editor Pane F | Tee [x] Table 


+ Swing Menus 
1 Quina Mindnmae 


Warto zwrócić uwagę także na Slider [4], 
czyli suwak. 

Wśród kontrolek gotowych do wyko- 
rzystania w projektach znajduje się też 
Progress Bar [1 Takiej kontrolki można 
użyć do pokazywania postępów w pracy 
aplikacji. 

Z kolei z kontrolki Radio Button HH 
można korzystać, kiedy mamy do zapro- 
gramowania dla użytkownika odpowiedź 
jednokrotnego wyboru. Kontrolki tego 
typu połączone w jedną grupę będą ze 
sobą współpracować tak, że tylko jedna 
znich będzie mogła być zaznaczona. To 


[Gie Menu Bar 


EJ Dialog 


przydatne, gdy musimy stworzyć aplikację, 
która będzie testować wiedzę użytkowni- 
ka poprzez quiz, w którym tylko jedna 
odpowiedź na dane pytanie może być 
poprawna. 
W palecie znajdują się też bardziej roz- 
budowane kontrolki - tu należy zwrócić 
uwagę na Tree [l Kontrolka ta pozwala 
na wyświetlanie drzewa lokalizacji 
w oknie programu. 
Oprócz kontrolek widocznych w katego- 
riach Swing Controls i Swing Contai- 
ners warto też poznać inne kategorie, 
jak na przykład Swing Menus .Tu 
znajdziemy kontrolki, które pozwolą na 
budowę menu aplikacji w pełni zgod- 
nego z naszymi założeniami projektu. 
Wśród kontrolek znajdziemy też katego- 
rię AWT, a w niej kontrolki przypomina- 
jące to, co widzimy w Swing Controls, 
jest to jednak starsza biblioteka zawierająca 


kontrolki graficzne. 
—. swing Menus 
[EJ Menu 
= | Menu Item [== Menu Item / CheckBox 
E-| Menu Ttem / Radiofutton Ev Popup Menu 


Separator 


[x Color Chooser F7) File Chooser 


(45) Opton Pane 


+) Swing Fillers 
+ AWT 
+ Beans 
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Testy 


Testowanie jest ważnym aspektem tworzenia 
oprogramowania. Pozwala uniknąć sytuacji, gdy do 
użytkowników trafia oprogramowanie z błędami. 

Błędy - wiadomo - mają negatywny wpływ nie tylko 

na funkcjonalność programu, ale też na wizerunek twórców 


wypadku oprogramowania tworzo- 

nego komercyjnie testy mają duże 
znaczenie dla budżetu projektu - im wcze- 
śniej wykryjemy błąd, tym niższy jest koszt 
jego naprawienia. Należy zatem wykryć 
błędy w najwcześniejszej możliwej fazie, 
w trakcie pisania kodu programu. Dlatego 
każdy szanujący się programista powinien 
testować kod, który napisze. Oddając kod 
do użytku, powinien być pewny, że działa 
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on tak, jak powinien. Jak organizować te- 
sty? Czy należy wielokrotnie uruchamiać 
pisany program i sprawdzać różne moż- 
liwe do wykonania przez użytkownika 
operacje? Czy nie będzie to zbyt żmudne 
i czasochłonne? Czy taki sposób testowania 
byłby efektywny? Na szczęście inżynieria 
oprogramowania jako nauka wypraco- 
wała odpowiednie mechanizmy - testy 
jednostkowe. 
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Testy jednostkowe 


j jeż jednostkowy jest to działanie testo- 
we tworzonego przez nas oprogramowa- 
nia. Testy te opierają się na pisaniu metod 
testujących krótsze części kodu, tak zwane 
jednostki - stąd ich nazwa. 

Weryfikują one poprawność działania po- 
jedynczych elementów, takich jak meto- 
dy, obiekty lub procedury. To, co testuje- 
my, zależy od wybranej przez nas ścieżki 
programowania. 

Wykonując taki test, uzyskujemy wynik, 
który następnie należy porównać z oczeki- 
wanym rezultatem. Będzie on albo pozy- 
tywny, albo negatywny - wpisze się w ramy 
naszych oczekiwań lub też nie. 

Robi się to po to, by uniknąć skutków, ja- 
kie może powodować niewykryty błąd. Im 
szybciej wyłapiemy nieprawidłowość, tym 
mniejsze będzie spustoszenie w kodzie pro- 
gramu w dalszej części pracy. 

Jeżeli chcemy poświęcić czas na testowanie, 
należy przygotować się na to już w trakcie 
pisania kodu - tak aby możliwe było wyko- 
nywanie na nim sprawdzianów. 

Jednak należy pamiętać, że nie cały kod da 
się pokryć testami. Trzeba to zrobić w wy- 
padku najbardziej newralgicznych frag- 
mentów. Idealną sytuacją jest, gdy mamy 
testy z wymaganą funkcjonalnością i kod, 


który spełnia ich założenia. Uruchamiając 
test, dowiemy się, czy program działa pra- 
widłowo, bez rzeczywistego uruchamiania 
całego programu. To niewątpliwa zaleta te- 
stów jednostkowych. Wykonywanie ich na 
bieżąco umożliwia wykrycie błędu i jego 
lokalizacji we fragmencie kodu, zanim trafi 
on do programu. 

Wymienione powody sprawiają, że testy jed- 
nostkowe są popularne w programowaniu 
ekstremalnym. 


Podział testów jednostkowych 
Testy jednostkowe można podzielić na kilka 
kategorii: analiza Ścieżek; użycie klas równo- 
ważności; testowanie wartości brzegowych; 
testowanie składniowe. 


m W teście, który wykorzystuje analizę 
ścieżek, określamy punkt początkowy oraz 
punkt końcowy dla przeprowadzenia testów 
i badamy przebieg możliwych ścieżek pomię- 
dzy nimi. Możliwe ścieżki od punktu począt- 
kowego do punktu końcowego dzielimy na 
dwa podejścia: 
e przetestowaniu podlega każda możliwa 
Ścieżka w każdej funkcji, 
e pętla uniemożliwia wykonanie testu na 
ścieżce. 


PROGRAMOWANIE EKSTREMALNE 


To sposób programowania mający na 
celu wydajne tworzenie małych i średnich 
projektów wysokiego ryzyka, czyli takich, 
w których nie wiadomo do końca, co się 
tak naprawdę robi i jak to prawidłowo 


zrobić, bo zazwyczaj nie są one opra- 
cowywane według ściśle opisanego 
projektu, ale projektowane na bieżąco. 
Jest to koncepcja prowadzenia projektu 
informatycznego na podstawie obserwacji 
innych projektów, które odniosły sukces. 
Jednym z elementów programowania 


ekstremalnego jest na przykład pisanie 
w parach, gdy jedna osoba tworzy kod, 
a druga kontroluje piszącego i sprawdza 
poprawność napisanego kodu. Progra- 
miści pracujący w ten sposób zamieniają 
się rolami na kolejnych etapach. Inną 
cechą programowania ekstremalnego 
jest stała współpraca z osobą zlecającą 
stworzenie oprogramowania - często 
bez wytworzenia specyfikacji na bieżąco 
wprowadza się modyfikacje na podstawie 
zaleceń zleceniodawcy. 
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testy 


W sytuacji gdy zastosowaliśmy w kodzie 
pętlę i niemożliwe jest wykonanie testu 
jednostkowego, możemy zastosować dwie 
grupy testów: Boundary test (działania 
w pętli nie są wykonywane lub działania 
w każdej pętli są wykonywane raz i dodat- 
kowo wszystkie ścieżki wewnątrz pętli są 
wykonane raz, po wykonaniu testu zwra- 
cana wartość to zero lub jedno przejście) 
i Interior test (działania we wnętrzu pętli 
uważa się za przetestowane, jeśli zostały wy- 
konane wszystkie ścieżki, które są możliwe 
przy dwukrotnym powtórzeniu pętli, po 
wykonaniu testu zwracana wartość to dwa 
przejścia). 


m Podczas przeprowadzania testu klas rów- 
noważności używa się klasy równoważności, 
które są zbiorem danych o podobnym sposo- 
bie przetwarzania. Aby klasa została uznana 
za poprawną, test wykonuje się jedynie na kil- 
ku elementach zbioru. Klasy równoważności 
dzielą się na: 

e klasy poprawności - przewidujemy 

poprawne wykonanie programu, 


JUnit 


D o tworzenia powtarzalnych testów jed- 
nostkowych oprogramowania napisa- 
nego w języku Java służy narzędzie JUnit. 
NetBeans IDE wykorzystywane do progra- 
mowania w poprzednich rozdziałach ma 
wbudowane mechanizmy tworzenia plików 
testowych dla narzędzia JUnit. Skorzystamy 
z nich, jednak najpierw należy utworzyć 
pusty projekt, do którego można dodać plik 
z klasą. W pliku tym możemy umieścić nastę- 


e klasy niepoprawności - przewidujemy 
błędne wykonanie programu. 


m Kolejny rodzaj testu jednostkowego - test 
wartości brzegowych - to rozwinięcie te- 
stu klas równoważności. Wartością brzego- 
wą nazywamy element zbioru klasy równo- 
ważności, który znajduje się w pobliżu jej 
granicy. Wartości, które testujemy, to takie, 
które należą do zbioru, ale także te, które nie 
należą do niego, ale ich wartość jest zbliżona 
do granicznych wartości zbioru. 


m Testowanie składniowe, czyli kolejny 
rodzaj testu jednostkowego, opiera się na 
sprawdzeniu poprawności danych wprowa- 
dzanych do systemu. Możliwe błędy są za- 
leżne zarówno od systemu, jak i środowiska: 
e wymuszone wartości pól (bazy danych), 
e autokorekty (MS Office). 
Zasada „garbage in - garbage out” jest pod- 
stawą w testowaniu tego rodzaju, jednak 
zadziała, jedynie gdy brakuje mechanizmu 
sprawdzania danych na wejściu lub testów 
na tolerancję systemu na błędne dane. 


package com.mycompany.testowy; 

/ 4 lines */ 

public class OTestowaniu ( 
public int[] liczby = new intl10]; 
public static void main(String args[1) I 


ł 
public OTesLtowaniu() ( 
for (int i = O0;i<10;i++) 


yli] = i*(i41); 


pujący skrypt 6. To prosta klasa zawierająca oo 


metodę dotyczącą listy liczb całkowitych 
i typu boolowskiego, pozwalającą spraw- 
dzić, czy podana liczba znajduje się na liście. 
W ramach ćwiczenia możemy przeprowadzić 
testy sprawdzające, co zwraca metoda, gdy 
podamy jej konkretne liczby do sprawdzenia. 
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if (x==i) return Lrue; 


> 


return falsa; 
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QO Create/Update Tests > 


Najpierw trze- | Tools Window Help 


Class to Test: com.mycompany.testowy.O Testowaniu 


ba wygenero- Apply Dift Patch.. .G 
wać plik z testami. patch mg Class Name:  com.mycompany.testowy.O TestowaniuTesf 


Test Packages v 


W tym celu rozwi- 
jamy opcję Tools 
z menu górnego 
i wybieramy pozy- 


B Localon: 


Internationalization 
Open Java Platform Shell 


Framework: JUnit w 


Integradon Tests 


Java Platforms 
cję Create/Update Ant Variables The existing test dass wall be updated. 
Libraries | 
tests Code Generabon 
Servers 
Cloud Providers Method Access Levels Generated Code 
W nowym Ok- Templates /] Publie /] Test initalizer 
nie możemy wy- PP DESTOĆ zest ©) Protected 7) Test Finalzec 
z E y Y Palette > tO 1 
brać lokalizację Pługi itie „| Package Prvate 2] Test Class inidalizer 
pliku w projekcie ze ©) Test Class Finalizer 
: ptions 
i Framework 2] Default Method Bodies 
. . 5 Generated Comments 
Program wygeneruje oddzielny plik CZCZO 


z testami jednostkowymi. Każda meto- 
da z klasy ma w pliku z testami stworzony 
swój odpowiednik do testów. I tak dla meto- 
dy typu boolowskiego z klasy głównej w pli- 
ku z zapisem testów znajduje się metoda 
testCzyZawiera ©, której definicja może już 
zawierać pewien rodzaj testu jednostkowego. 


(2) Source Code Hints 


E OK Cancel Help 


metodę był inny niż ten, jaki faktycznie został 
zwrócony. W takim wypadku trzeba prze- 
analizować definicję metody - być może 
popełniono w niej błąd logiczny podczas 
tworzenia algorytmu jej działania. 


Działanie tej metody polega na określe- 
niu, czy wartość zwracana przez metodę 


Grest 
public void - 
System.out.println("czyZawiera"); 


int x =U0; 

OTestowaniu instance = new OTestowaniu ():; 
boolean expResult = false; 

boolean result — instance.czyZawiera (x); 
assertEquals(expResult, result); 


fail("The test case is a prototype."); 


) 
czyZawiera jest taka sama jak wartoŚć | Ś Tesoreswsanu> © powanozawarae ) 
oczekiwana dla danej liczby. Oczekiwa- |Notfications Output _ Test Results 
ny wynik zwrotu dla konkretnej liczby <om.mycompany: Testowyzjar:1.0-SNAPSHOT (Unit) x 
może przyjąć wartość true lub false. |* nana 

NME Ę A at java basefjdk.nternal reflect NativekethodAccessortmpi.imvoke0(Hative Method) 

Po uruchomieniu testów program po1n- R NA REA ZO OOO 
formuje nas o ich wynikach , Wskaże © at java .base/jdk.nternal.refiect DelegaongMethodAccessorImpl.irwoka( DełegatngH ethodAcceśs 
A ki ś h ł li ŚLi EŃ at Java.base/java lang.refectMethod.invoke(Method.java:567: 
ja procent Z NiC zosta za iczony. Jeś 1 [') at org.apache.maven.surefire.ut/.RefiechonUnis.nvoxeMathodwitnArray(RefiecwonUtis Java: 101 
testy maja wynik failure - oznacza to at org.epache.maven.sur efire.booter.ProiderFactory$PI owder Proxy nvoke(ProwderFactory.jav4 
a : : at org.apache.maven.surefire.booter.PronderFactory.invokeprovider(ProviderFactory.java:85) 
ze o wynik zwracany pr zez s a ak Buck BodbactaninencatEnikadankać Lua 181 | 
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Logi 


Nawet najlepiej przetestowane oprogramowanie może nie 
uchronić się przed występowaniem drobnych niepoprawności. 
W celu ich wyłapania często stosuje się zapis wykonywanych 


przez użytkownika czynności 


liki zawierające chronologiczny zapis zda- 
rzeń - czynności wykonywanych przez 
użytkownika programu - są nazywane loga- 
mi. Pliki te są tworzone przez programy auto- 
matycznie, jednak to programiści muszą stwo- 
rzyć system zapisywania logów z programów. 


Po co stosować logi 

Logi są używane nie tylko do wykrywania 
ewentualnych nieprawidłowości w działa- 
niu programu, ale też do analizowania pracy 
systemu informatycznego, na przykład spo- 
rządzania statystyk czy wykrywania prób 


KONTROWERSJE 


W przypadku różnego rodzaju komu- 
nikatorów logi mogą zawierać wykaz 
wiadomości oraz połączeń. Także inne 
informacje przechowywane i archiwizo- 


wane w formie plików log mogą nieść 
za sobą zagrożenia związane z ochroną 
prywatności. Uzyskanie dostępu do tych 
plików przez niepowołane osoby może 
doprowadzić do ujawnienia poufnych 
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włamań do systemu wraz ze sposobem ich 
przeprowadzania. Oczywiście logi mogą 
zapisywać informacje w sposób mniej lub 
bardziej szczegółowy - poziom szczegóło- 
wości logowania zależy od celu, w jakim 
chce się ich użyć. Do wykrywania błędów 
w funkcjonowaniu oprogramowania ko- 
rzysta się zwykle z najwyższego poziomu 
szczegółowości. 


Co mogą zawierać logi 
Informacje zawarte w logu mogą dotyczyć 
różnych aspektów użytkowania programu 


danych. Jest to jednak konsekwencja 
dbania o bezpieczeństwo, ponieważ brak 
plików log uniemożliwia analizę włamań 
czy awarii. 

Zdarza się, że logi są dowodami prze- 
stępstw - są przekazywane organom 
ścigania, gdy wykazują włamania bądź 
też nieprawidłowe wykorzystanie systemu 
przez użytkowników. 
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- zarówno tego, co użytkownik robi z pro- 
gramem lokalnie, jak też tego, jakie treści 
są przesyłane na interfejs sieciowy. Log jest 
zbiorem chronologicznych wpisów. Każdy 
taki wpis standardowo zawiera: 

m rodzaj zdarzenia, jakie wystąpiło, 

m czas, w jakim doszło do zdarzenia, 


Logback 


la programistów pracujących 
w języku Java powstała bibliote- 


import org.slf4j.Logger; 


m nazwę użytkownika, który wygenerował 
zdarzenie, 

m pliki, na jakich operowało zdarzenie, 

m opis zdarzenia. 

Zawartość pliku log zależna jest od specyfiki 

oprogramowania, którego działanie log ma 

rejestrować. 


LIICS; 


ka Log4j, która pomaga tworzyć pli- 


?. Search Dependency at Maven Repostories tor org.sit4j.l ogger 


ki log. Wciąż jest to jedna z bibliotek 
najczęściej wykorzystywanych do tego celu, 
jednak sam projekt nie jest już rozwijany, 
a część osób zaangażowanych w pracę z nią 
rozwija teraz bibliotekę Logback. To ona jest 
obecnie rekomendowanym narzędziem do 
tworzenia plików log. 


że te biblioteki trzeba najpierw dodać do pro- 
jektu, zanim można będzie je importować. 
Tu z pomocą przychodzi Maven - klikamy 
na ikonę błędu przy bibliotece i wybieramy 
Search Dependency at Maven Repositories 
for org.sif4j.Logger ©- 


private Timer timer; 
private String stanGry — "trwa"; 


private Logqer loq = Loqqerkactory.getLogger(PanelGry.class) ; 


Program powi- 
nien wyświetlić 


By móc tworzyć pliki log, niezbędne 

jest stworzenie obiektu, który będzie 
za to odpowiadał. Gdybyśmy tworzyli logi 
do Arkanoida stworzonego w rozdziale 3, 
taki obiekt można byłoby utworzyć linij- 
ką: private Logger log = LoggerFacto- 
ry.getLogger(PanelGry.class); 6, gdzie 
PanelGry.class jest nazwą klasy, w której 
umieszczamy tworzenie logów. 


Domyślnie zarówno Logger, jak i Log- 

gerFactory nie będą rozpoznane przez 
program. By były - trzeba dodać odpowied- 
nie importy, odpowiednio import org.sif4j. 
Logger; oraz import org.sif4j.LoggerFac- 
tory; ©. 


% | import org.slf4j.Logger; 
% import orq.s 1 t4j R LoggearFactory; 


Co istotne - importy także mogą nie być 
rozpoznane przez program. To dlatego, 


nowe okno, w któ- 
rym powinna się znaleźć opcja org.slf4j : 
slf4j-ap © - należy ją zaznaczyć i dodać do 
projektu, klikając na przycisk Add 


© Search In Maven Repositories x 


Class Name 
jorg.sIfaj Logger 
Matching Artfacts 


HA orgcodchaus.groowy : groowy 


*a 


org.slfaj : sifajsapi : 1.7.5 [ jar ] 


Z obiektu można korzystać, wywołu- 
jąc dostępne dla niego metody - jak 
na przykład debug. By rejestrować każde 
przesunięcie paletki w przypadku naszego 
Arkanoida, można dopisać wywołanie wspo- 
mnianej metody w metodzie odpowiedzial- 
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logi 


private class Sterowanie extends KeyAdapter f 


GOverride 
public void keyPressed(Keykvent e) | 
int key = e.getKeyCode () ; 


if (key == KeyEvent.VK LEFT ś« xp > 0) ( 
xp = xp - 10; 
log.debug("Paletka-strOnd: lewa"); 


it (key == KeyFvent.VK RIGHT ££ xp < OKNO_SZFR — szerPaletki) ( 
xp = xp + 10; 
log.debug ("Paletka-strona: prawa"); 


ł 


nej za przesuwanie paletki na boki - pisząc 


Projects X | Tiles Services -— 


log.debug("”Paletka-strona: prawa”); 


(i analogicznie dla strony lewej). © $b Arkanoid A 
- w ArkanoidKS 

Po wprowadzeniu tego zapisu na stan- =-(4 Source Packages 

dardowym wyjściu w NetBeans powinny =. Ą ram.mycomnanyartanoidks 
pojawić się już wpisy © zawierające informa- [EB Okno.iava 
cje o ruchu paletki. [EJ PanelGry.iava 

G- (BT Test Packages 

Plik konfiguracyjny E (6 Other Sources 

Domyślnie Logback kieruje wpisy na kon- Ę (a Dependencies 

solę. Można jednak zmienić jego konfigu- F-|_g_ Java Dependencies 
rację. W tym celu dodaje się do projektu plik *- [ją Project Files 
logback.xml. By go dodać, trzeba utworzyć 
dla niego odpowiednią lokalizację w struk- Rozwijamy za- |, — 
turze projektu. Domyślnie projekt jest przez wartość folde- 5 mn 
NetBeans wyświetlany w taki sposób, że | rusrce © z projektu, p z. 
struktura folderów nie jest widoczna. By | do którego chcemy 8 Pyza 
wyświetlić projekt w formie drzewa plików, | wprowadzić two- "| 
klikamy na zakładkę Files rzenie logów. B preysa 


Test Results | Qutp.. x 


W Debugger Console x Run (ArkanoidkS) x Run (ArkanoidkS) x 

PE had ik a w DW [AW WZ YTL WE WOM J MZ M Wi MY M Wiki Y - BL ROL MAD |. FRsTLILY — FALTELAC"DLLUR. LAWA 
12:32:11.376 [AWI-EventQueue-0] DEBUG com.mycompany.arkanoidks.PanelGry - Paletka-strona: prawa 
12:32:11.517 [AWI-EventQueue-0] DEBUG com.mycompany.arkanoldks.PanelGry — Paletka-strona: prawa 
12:32:11.674 [AWI-EventQucue-0] DEBUG cum.mycompany.arkanoidks.PanelGry — Paletka-strona: prawa 


12:32:12.10€ [AWI-EventQueue-0] DEBUG com.mycompany. arkancidks „PanelGry -— Paletka-strona: lewa 
12:32:12.358 [AWT-FvenrQueue-0] DERUG com.mycompany.arkanoidks.PanelGry - Palerka-strona: lewa 


8 EB 


12:32:12.539 [AWI-EventQueue-0] DEBUG com.mycompany.arkanoidks.PanelGry - Paletka-strona: lewa 
12:32:12.729 [AWI-EventQueue-0] DEBUG com.mycompany.arkanoidks.PanelGry — Paletka-STrona: lewa 
12:32:12.3557 [AWI-EventQueue-0] DEBUG com.mycompany.arkanoidks.PanelGry — Paletka-strona: lewa 
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= QD Arkanoldkś = 
- ste 
2 [7 8 5! impq 
ką j” Name and Location 
ad mef | EB 0a Doamat. File Name: loghach 
Cut Ctri=X [ED JFrame Form.. | 
Copy Ctrl+C © JavaClass_ 
Paste tri+ LL Panel Form... Project ArkanoidkS 
| QB ImwaPackage.. 
By agi rook EA Jave Interface. Folder: srcjmainiresources 
* G targg Rename_ - > 
(ie vom. © webSerice Client. 
8 BotPrzykii History > | Created File:  ntsiNetReansProjects|mavenprojecrt?iRozdział 31Arkanoidk| 
szykli 
Other... 
© DL mavenor4 1 a w, 


W folderze main trzeba utworzyć fol- 

der resources - w tym celu klikamy 
prawym przyciskiem myszy na folder main 
i wybieramy New, a następnie Folder 


W nowym oknie podajemy nazwę pliku 
- logback © - i klikamy na Next. 


Pozostawiamy domyślne ustawienia i kli- 
kamy na przycisk Finish ©, by utworzyć 
W nowym oknie podajemy nazwę two- dokument. 
rzonego właśnie folderu © i zatwierdza- 
my przyciskiem Finish. 


Select Document Type 


Select the type of XML document you want to create based on your document strucj 


Name and Location namespace requirements. 


Folder Name: resources 


© elformed Documeni 


Project Arkanoidk5 QQ DTD-Constrained Document 


ParentFolder:  srcvnain (©) xML Schema -Constrained Document 


Created Folder: a|Documents|NetBeansProjects|imavenproject2iRozdział ZVArkan| 


Klikamy prawym przyciskiem myszy 
na nowo utworzony folder i wybieramy 
z menu New i XML Document 


< Back Next > 


= — 
| s mr>uurorm © Folder Przykładowy plik konfiguracyjny dla Log- 


omomi 


back może mieć następującą formę ©. To 


c Cri+x | EE Framefom. 22 i : : o 
ssd cy  Gaic IA lasce. właśnie w pliku konfiguracyjnym określa się 
amowaneu| | Paste  Cmev | ©) sPanelform.. lokalizację pliku log czy też podstawową za- 

| Delete Delete | va Pacage. wartość wpisu. 
I n 2 Java Interface. 


<?xml version="1.0" encodinq="UTF-0"?> 
<configuration> 
<appender name="tileAppender" class="ch.qos.logback.core.FileAppender"> 
<file>c:/myLogFile.log</file> 
<append>true</append> 
<encoder> 
<pattern>$d [$thread] %-5level %logger(35) - *msg*tn</pattern> 
</encoder> 


</appender> 


<root level="TRACE"> 
<appender-ref ref="fileAppender" /> 


</rooL> 


</configuration> 
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Dokumentacja 


Dokumentacja to nie tylko instrukcje przydatne dla 
użytkowników, ale też dokumentacja techniczna przeznaczona 
dla osób, które chcą edytować program — rodzaj ściągawki 
ułatwiającej pracę, a także naukę kodowania 


Czym jest dokumentacja 


Ww skład dokumentacji programu wchodzi 
zarówno dokumentacja użytkownika, 
jak i dokumentacja techniczna przeznaczona 
dla osób mających edytować program. I właś- 
nie tego rodzaju dokumentacją zajmiemy się 
w tym rozdziale. Na marginesie: Warto wie- 
dzieć, że dokumentacja to jeden z ważnych 
działów inżynierii oprogramowania, dziedzi- 
ny nauki porządkującej kwestie związane 
z tworzeniem programów. 

Dokumentacja techniczna często jest wytwa- 
rzana za pomocą dodatkowego oprogramo- 
wania i w pewien sposób generowana auto- 
matycznie, by zmniejszyć nakłady pracy z nią 
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związanej. W przypadku Javy narzędzie do 
generowania dokumentacji jest w pakiecie 
z językiem. A to oznacza, że jest standardowe 
- nie jest specyficzne dla wykorzystywanego 
IDE, ale uniwersalne. Nazywa się Javadoc 
i pozwala na generowanie dokumentacji na 
podstawie komentarzy. Zgodnie z powszech- 
nie panującą opinią pisanie dokumentacji jest 
czynnością, którą programiści wykonują nie- 
chętnie - Javadoc znacznie przyspiesza ten 
proces. Korzyści z posiadania dokumentacji 
znacznie przewyższają nakłady czasu ponie- 
sione na jej tworzenie. Warto dbać o to, by 
ja na bieżąco generować. 
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Jak korzystać z Javadoc: 
dokumentacja do Arkanoida 


J avadoc generuje dokumentację na pod- 
stawie komentarzy, trzeba je jednak w pe- 
wien sposób schematyzować, by program 
mógł je rozpoznać. 

Oznaczenie komentarza, który ma być wi- 
doczny dla Javadoc, jest nieco inne od stan- 
dardowego. Taki fragment kodu umiesz- 
czamy pomiędzy znacznikami /** - na 
początku, i */ - na końcu. 


53 pl- public PanelGry () || 
54 initCcomponents (); 


55 setBackground(Color.black) ; 
carurafarradcirafnaw Ii 


Jeśli przyjrzymy się komentarzom ©, któ- 
re pojawiły się w naszych skryptach wraz 
z generowaniem fragmentów kodu przez 
program, zauważymy, że część z nich jest 
oznaczona właśnie w ten sposób. Już na 
tym etapie IDE wspiera nas w tworzeniu 
dokumentacji. 


Gdzie umieszczać komentarze 

Komentarz do wygenerowania dokumenta- 
cji umieszczamy zawsze przed elementem, 
którego ma dotyczyć. Komentarze mogą od- 


nosić się do klasy, metody, pakietu, pola klas 
- praktycznie do wszystkiego. 

Dla przykładu stwórzmy dokumentację do 
projektu Arkanoid, który został opisany 
w rozdziale 3. Zacznijmy od komentarza 
dotyczącego klasy - powinien on zostać 
już wygenerowany, a w jego treści znajduje 
się linijka zawierająca nazwę autora projek- 
tu. Składa się ona z parametru Qauthor 

i nazwy użytkownika, który tworzył pro- 
jekt. Zamiast tej nazwy możemy umieścić 
tam swoje imię i nazwisko lub pseudonim, 
pod jakim chcemy rozpowszechniać swoje 
oprogramowanie. 


Co napisać w komentarzu 

m Każda linijka w komentarzu zaczyna się od 
znaku gwiazdki - *. Tego też wymaga Java- 
doc. A jaka powinna być treść komentarza? 
W pierwszej linijce należy umieścić krótki 
opis przeznaczenia danego elementu. I tak 
w przypadku panelu z gry Arkanoid można 
napisać: Panel służący do wyświetlania 
elementów gry ©. 
m Dalej prócz oznaczenia autora można 
umieszczać też inne tagi - tak określamy 
nazwy, które w komentarzach poprzedzo- 
ne są znakiem małpy, czyli ©. W przypad- 
ku dokumentacji klasy warto użyć też tagu 


import java.awt.FontMetrics; 


public class PanelGry extends javax.swing.JHanel implements ActionListener i 


import java.awt.FontMetr1cs; 


public class PanelGry extends javax.swing.JPaneal implements ActionT.istener ( 
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| dokumentacja 


©see, który tworzy wpis w specjalnej sekcji 


public class PanelGry extends javax.swinq 


dokumentacji see also. Sekcja ta dodaje od- 
niesienia do innych treści. Możemy tutaj wpi- 
sać dowolny tekst, na przykład tytuł książki 


wyświetlania e ntów gi 


czy nazwę innej dokumentacji. W naszym 
przykładzie warto dodać odniesienie do kla- 
sy JPanel, poprzez dopisanie ©see javax. 
swing.JPanel ©- 

m Tak jak dla całej klasy, tak i dla jej pól moż- 
na tworzyć komentarze w formie Javadoc 
do wygenerowania dla nich dokumentacji. 


Przydatne tagi 


W: zapoznać się z tagami, jakie moż- 
na wykorzystać, by móc zdecydować, 
którego z nich użyć. 


TAG PARAMETRY USŁUGI 

©param parametru i jego działanie 

Qreturn Służy do określenia, jaką wartość zwraca metoda 
©Qsince Pozwala określić, od kiedy trwają prace nad projektem 
AAC gdy ta jest już wygenerowana 


private final int OKNO SZER = 600; 


private final int OKNO WYS = 500; 


Służy do opisania parametru metody. Wykorzystując go po tagu, należy wpisać nazwę 


Pozwala na wprowadzenie numeracji wersji i numer wersji wyświetla w dokumentacji, 


private int szerPaletki = 100: 


W przypadku pól klasy najlepiej zapisać ©, 
do czego służy każde z nich. 


Stosując podane poniżej parametry, możemy 
spróbować opisać wszystkie metody z pliku 
PanelGry.java. 


Dokumentacja — plik HTML 


G otowa dokumentacja jest plikiem HTML, 
czyli takim, który otwierany jest przez 
przeglądarki internetowe. Takie rozwiązanie 
ma sporo plusów. 

Przede wszystkim można samodzielnie edy- 
tować wygląd dokumentu poprzez umiesz- 
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czanie w komentarzach fragmentów skryp- 
tów HTML. Inną zaletą takiego rozwiązania 
jest wygodna możliwość umieszczenia takie- 
go pliku na serwerze, by jako strona inter- 
netowa był łatwiej dostępny dla osób, które 
z niego korzystają. 


W KŚ+ znajdziemy e-wydanie tej Biblioteczki, 
obraz ISO dołączonej do niej płyty z narzę- 
dziami dla programistów i pliki szkoleniowe 
do wskazówek opisanych w książce. 


Otwieramy stronę www.ksplus.pl. Logu- 
jemy się © (używamy konta z serwisu 
Komputerswiat.pl). Jeżeli nie mamy konta, 
klikamy na ©, by się zarejestrować. 
Załóż konto Logowanie 
Po zalogowaniu się możemy zareje- 
strować kod nadrukowany na płycie 


dołączonej do książki. . 
wystarczy kliknąć na UKSUZSK 


link t przepisać kod. Zarejestruj kod 


Uzyskamy 
w ten spo- 
sób dostęp do 
e-wydania © i do 
bonusowego 
obrazu płyty ©. 
Do serwisu KŚ+ 
możemy logować się z dowolnego urządze- 
nia z dostępem do internetu. 


UWAGA! W KŚ+ ZA DARMO E-WYDANIE KSIĄŻKI ORAZ PLIK ISO PŁYTY 


POLECAMY INNE NASZE bia 


Kor omputeń = gadu 
POZNAJ METODY 


SPOSOBY NA HAKERÓW 


Poradnik krok po kroku, jak sprawdzać 
bezpieczeństwo naszej sieci i urzą- 
dzeń oraz blokować możliwości ataku. 
Na DVD Kali Linux do testów bezpie- 
czeństwa, a w KŚ+ superpakiet do 
zabezpieczania Windows. 


- TOSAM > 40 
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TRIKÓW DO NAJLEP 
R I 


NARZĘDZI GRAFIC7 
als | 
AL Ę: m sg 


PAJIEOTYLULTUIWĄ RY: 


100 TRIKÓW DO ZDJĘĆ 


Najlepsze triki do najlepszych darmowych 
programów graficznych: poprawianie 

i retusz, efekty i filtry, fotomontaże, własne 

projekty. Na DVD narzędzia pokazane we 
wskazówkach, a w KŚ+ - bank zdjęć. 


Nasze książki kupisz na www literia.pl/ksiazki 
Książki są również dostępne w wersji elektronicznej na www.ksplus.pl 


JAVA OD PODSTAW 


Java jest jednym z popularniejszych języków 
programowania i choć nie jest językiem 
najprostszym, zdecydowanie warto poświęcić 

czas na jego naukę. Java sprawdza się dobrze 

w wielu zastosowaniach. Z powodzeniem można 
tworzyć w tym języku nie tylko oprogramowanie 

i użytkowe, ale też gry. Największą zaletą Javy jest 
Konrad Jagaciak __ wieloplatformowość. Raz napisany kod można 

autor książki, uruchomić na wielu urządzeniach, korzystających 
programista z różnych systemów operacyjnych. Ogromną zaletą 
jest możliwość wykorzystania Javy do tworzenia 
gier i aplikacji mobilnych na urządzenia z systemem 
Android. Dedykowany temu program Android Studio 
to solidne i wygodne w pracy narzędzie. 


Nauka Javy otwiera przed początkującym 
programistą ogrom możliwości i nowych dróg 
rozwoju. 


W tej książce poruszono także kilka zagadnień 
istotnych z punktu widzenia inżynierii 
oprogramowania, jak testy, tworzenie dokumentacji 
czy pisanie logów. To tematy często pomijane 

na wczesnym etapie nauki programowania, a są 
bardzo ważne w pracy programistów. 


Na płycie dołączonej do książki i w KŚ+ 
(www.ksplus.pl) znajdziemy zestaw najlepszych 
narzędzi dla programistów oraz skrypty opisane 
we wskazówkach. 
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